[ https://issues.apache.org/jira/browse/JAMES-3360?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17180551#comment-17180551 ]
Ioan Eugen Stan commented on JAMES-3360: ---------------------------------------- Hi, To me user store , user repository, user directory are interchangeable in this context. However there are some details that might count against the name change. Are you talking about renaming the documentation or also the Java code? If it's just documentation rename we will have 2 names: Directory and Repository. If it's also Java code, then you will probably break some API. UserRepository is an interface that other people implement when they store users in other places. To me the value the rename brings is not worth the trouble and time spent to update the docs and the Java code and also break other people's implementations. > 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 > Priority: Major > > 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: server-dev-unsubscr...@james.apache.org For additional commands, e-mail: server-dev-h...@james.apache.org