Le 23/07/2020 à 15:44, David Leangen a écrit : >>>> Cool! I will try to take some time today to comment more thoroughly, >>>> likely in the form of a PR. >>> There is quite a lot of text there and a lot of concepts, so it will take >>> me a while to go through it. :-) >> Maybe more importantly than going through the entire text, the important >> question for me would be: >> >> - Which concepts do you miss to understand this doc? > I will need a bit more time. Take it :-)
It is not a problem if feedback comes a bit late. > >> - Can we address that with a better structure? > Ok, if I take a very quick top-down view, here are my immediate comments, > though I don’t know how useful they are. > > I notice that effectively you mention: > > * Running > * Configuring > * Operating > * Extending > > From our User Model, we have: > > • User —> Probably not relevant > • Operator —> Relevant > • Integrator —> Relevant > • Developer —> ???? > • Contributor —> ???? > • Committer —> ???? > • PMC Member —> Probably not relevant > > What were your thoughts regarding the target audience of these docs? Was it > your intention that: I'm targeting operators and integrators. This doc is not relevant for others. > > * Running —> Operator?? Yes. An operator needs to run the software. As guice servers are not (yet) available for download, an operator have either so far to compile the software or use docker images. See https://github.com/apache/james-project/pull/221 for adding a ZIP distribution of Guice servers that could be advertized on the dowload page. > * Configuring —> Operator?? Yes. > * Operating —> Operator (this one is clear) > * Extending —> Integrator (this one is clear, too) Here we are more targeting operators that happen to be also extension developers. Maybe I need to explain clearly here who the target audience is. > > Or did you have some other structure in mind? It’s difficult for me to grasp > exactly what you are intending. > > I would have thought that “Operating” includes Installing, Configuring, > Running. An Operator (as we define in the User Model) would naturally go to > the “Operating” section to figure out how to Operate the server. > > > Like I said, those are just my initial gut reactions. I’ll try to dig in more > next week. I believe the "Operating" session is misnamed then. Maybe I mean "monitoring & administrating". Would it address your concerns? >> I'm really looking forward into this review ;-) > Whew, pressure! Hope I don’t disappoint. 😜 > > >> Also note that I did not merge yet the most recent works and >> improvements for the Distributed Server doc... Do you want me to merge >> it before your review, to make it easier for you? > Please, yes! Thank you. Will do ;-) > > Cheers, > =David > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: server-dev-unsubscr...@james.apache.org > For additional commands, e-mail: server-dev-h...@james.apache.org > > --------------------------------------------------------------------- To unsubscribe, e-mail: server-dev-unsubscr...@james.apache.org For additional commands, e-mail: server-dev-h...@james.apache.org
