OOPM:Development:Documentation:HowTos:WikiDocuments
Documents in the Wiki
Introduction
For the purpose of documenting our software system, we will be using the MediaWiki.
MediaWiki provides a set of functions that will make documentation much easier.
- User defined Collections (aka Books)
- Templates
- Page Includes
- TBD
User Defined Collections
Whilst this is a rather handy feature, it also has a major shortcoming in that collections are either user property or communal property. No additional categories can be added to a collection so that it will be provided at the proper location in the hierarchy of pages in the OOPM wiki, for example the OOPM requirements analysis document must not be the sole property of a single user, as it is more or less a communal property. However, making it a communal property, will also cause it to appear in the Category:Collections, namely, in the reserved communal namespace MediaWiki:Collections.
Therefore we will employ our own mechanism for authoring multi page documents, instead of using the existing collections feature, so that we keep the global MediaWiki:Collections namespace free from pollution and also for making sure that we will not risk losing valuable information in case that a user deletes his or her account and, by that also, the collections made (part) property of that user.
Besides, browsing the Category:Collections category is both out of context and also rather awkward for the user, especially when more collections become available over time.
See the section on multi page documents below that will provide you with the information required to author multi page documents for the OOPM wiki. Such multi page documents can also be versioned according to the rules set forth in the document OOPM:Development:Documentation:Versioning.
Templates
TBD
Page Includes
TBD
Multi Page Documents
TBD
Single Page Documents
TBD
Page Includes
TBD
Templates
TBD