14 Jan
2014
14 Jan
'14
4:44 p.m.
On 14 Jan 2014 at 16:06:25, Patrick Masson
(masson@opensource.org(mailto://masson@opensource.org)) wrote:
Vincent,
Hmm reading my comment I see how poorly it was written--I was agreeing with you. Let me
try again...
"However your point about maintaining two sets of documentation [is a good one, that
I had not considered and it ] would be a pain [to maintain redundant FAQ content as the
technical aspects (and thus possibly the user interface) of XWiki changed] and [thus my
approach is] not a good idea.”
ahah, ok, all is good then :)
[snip]
However
your point about maintaining two sets of documentation would be a pain and not a good
idea.
Not sure I understood your point! :) Could you explain why it’s not a good idea to try to
have to maintain documentation content in a single place? I understand that we need
several ways to reach a documentation place and I agree with having a FAQ entry for this
precise example for that reason. However, I really think we need to try to have all
documentation about a given feature in a single location as much as possible. Always happy to be the "lowest common
denominator."
> Thanks for your help! Sorry to be a pest.
Not at all. Documentation is very important for a project and the fact that you couldn’t
find what you were looking for immediately is a concern to me. Please report any other
thing you cannot find easily and I’ll try to help to improve the documentation.
Also, if you have suggestion to improve documentation navigation please let us know (or
even participate as you did, this is most welcome!)
Thanks
-Vincent