On 14 Jan 2014 at 16:06:25, Patrick Masson ([email protected](mailto://[email protected])) wrote:
Vincent,
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.
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]
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