Hallo Rainer,
you raised this problem at the right time. I already started thinking about the future of the FAQ in the same direction as you did. There are certainly quite a few topics that belong to the "basic" part of the documentation.
Up to now it was relatively easy for me to insert information into the FAQ part of the Wiki. Here topics are and can be isolated. There is more or less no need to think about the right place in the documentation, the interference with other parts and so on.
My intention was to share with other users insight into QMS that I got while working with QMS (following Olivers call for contributions). And, of course, I played with QMS triggered by various discussions in the newsgroup and elsewhere. Thus, my QMS information comes from a users point of view and not from the designers/coders view (but I know that Oliver reads the contributions quite carefully and if there is a need he comments on them).
With regard to your proposal I see at least 2 questions which should be discussed before somehow re-arranging the Wiki:
* The list of contents of the Wiki in DocMain is relatively short and should certainly be extended due to the fact that QMS has plenty of useful features not yet described (some are now in the FAQ). Otherwise the Wiki pages are getting too long. And above of this: The structure of the list of contents should reflect the philosophy of the software designer!
* What is the best structure for the QMS Wiki? Is the linear structure proposed in connection with your toolset the best way to describe QMS or would a tree structure as normally used in Wikis to be preferred? I don't know how to answer this question. Both approaches have their pros and cons. Think what happens with the DocMain page when having there a much longer linear list of contents required by your tools!
Thank you for raising this discussion!
WolfgangTh
------------------------------------------------------------------------------
_______________________________________________ Qlandkartegt-users mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/qlandkartegt-users
