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 use:
{quote}a list of telephone numbers, names, addresses, or other information
{quote}
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
(v8.3.4#803005)

---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to