>>> 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.
> - 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:
* Running —> Operator??
* Configuring —> Operator??
* Operating —> Operator (this one is clear)
* Extending —> Integrator (this one is clear, too)
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'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.
Cheers,
=David
---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscr...@james.apache.org
For additional commands, e-mail: server-dev-h...@james.apache.org
