Difference between revisions of "OOPM:Development:Documentation:HowTos:WikiDocuments"
Line 18: | Line 18: | ||
a collection so that it will be provided at the proper location in the hierarchy of pages | 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 | 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 | + | property of a single user, as it is more or less a communal property, nor must it go into |
− | + | the global collections category page [[:Category:Collections]]. | |
− | |||
Therefore we will employ our own mechanism for authoring multi page documents, instead of | Therefore we will employ our own mechanism for authoring multi page documents, instead of |
Revision as of 19:11, 16 April 2009
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, nor must it go into the global collections category page Category: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