james-server-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "David Leangen (Jira)" <server-...@james.apache.org>
Subject [jira] [Created] (JAMES-3360) Change "User Repository" to "User Directory"
Date Tue, 18 Aug 2020 02:59:00 GMT
David Leangen created JAMES-3360:

             Summary: Change "User Repository" to "User Directory"
                 Key: JAMES-3360
                 URL: https://issues.apache.org/jira/browse/JAMES-3360
             Project: James Server
          Issue Type: Improvement
            Reporter: David Leangen

I wonder if there isn't a wording problem here.

I understand that the idea is to have a place to store user data. However, the naming looks
at the problem from a purely technical point of view. A "Repository" by definition is a place
to "put" something. For example, in the real world, a document repository is an actual place
to put documents.

The wording suggests that we have some place where we put people, which seems very strange
to me if we correspond the idea to the real world. It creates a very strange mental model
for me.

I think the concept that should be modeled here is more along the lines of a "Directory".
We have a kind of index that gives useful information about how to locate users. It is not
a place where we take people and lock them up. Rather, it is a list of information about people.
Does that make sense?

[Here is a definition|https://dictionary.cambridge.org/dictionary/english/directory] we could
{quote}a list of telephone numbers, names, addresses, or other information
Note that if the Repository is never exposed to anybody except implementors, and it really
is just a place to put data, then this issue would not bother me. However, it is my understanding
from writing the new documents that this concept is actually exposed, so I think the concept
needs to be fixed.

This message was sent by Atlassian Jira

To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org

View raw message