Agree completely, Mourik!
'high-end' people will already know what's being suggested, and
'low-end' people will not read 200 pages! I'm a 2-3 year 'low-end'
administrator (i.e., 'newbie'), and I wouldn't read 200 pages to get it
installed.
It's too confusing! That's why I chose the ZEG On the other hand, I'm
now reconfiguring a "new" ZEG mostly so I can learn how to "rebuild" it
should I need to do so (or "build" it for others)
I am interested in scripts that automate the process (or most of the
install) I think that sounds great!
And, by the way, in another life, I am a document (and documentation)
writer. I want it clear and concise! I want all the confusion
off-the-table, and including all those definitions just clutter it up.
That's what the internet (and Wikipedia) are for (find out what I don't
know)
Even HOWTOs require some adjustment in situations different than how it
was written, so that doesn't always solve the problem for newbies. I'm
glad for HOWTOs, as they show how someone else did it.
Just my opinion! Many thanks to the Inverse team and this mailing list
for all the helps.
On 07/08/2013 03:59 AM, mourik jan heupink wrote:
Hi,
Because two folks told you they like the doc how it is while you said
yourself two times it was horrid and you're ready to drop the ball? I
appreciate the comments you provided, but if you voice your opinion, be
ready to accept what others tell you.
Yes!
I can only say that the docs were very helpful to me. Sure, nothing is
perfect, but I completely disagree with almost all your suggestions to
improve the documents.
We are have been running SOGo in production for a few months now, and
even though we had some (minor) problems, most of those had nothing to
do with the documentation. There is much knowledge and specific
information in this list and it's archives. No need to duplicate those
in the docs.
In fact: most of your 'improvements' sound to me like duplicating
information that can easily be found someplace else.
In fact: (using your terminology) The 'high-end' people will either
know what everything means, or know where to find that out themselves.
And "low-end" people will never read a 200 page document just to
install SOGo.
So sure: all docs can always be improved, including SOGo's, but I
almost completely disagree with your suggestions how to do so.
MJ
--
[email protected]
https://inverse.ca/sogo/lists
