About the Tiki Documentation | ||||
Since the Tiki project started in 2002 there have been over 200 different developers working on over 50 separate releases (major & minor), creating hundreds of features, over 1000 preferences/settings, with over 1 million lines of code and 7500 wiki pages created in the tikiwiki.org domain. Needless to say, developing an authoritative documentation for this open source project is challenging. From the beginning until version 1.6, the Tiki documentation was a one-man effort. The 1.6 Documentation complete with 350 fully illustrated pages with screenshots provided the basis for what exists at doc.tiki.org today. Since that version, the Tiki project has chosen to eat its own dogfood. Not unlike a baby learning to feed itself, the results have been a little messy. We now have more than 2300 wiki pages on http://tikiwiki.org with several pictures and miscellaneous useful content. But as it's wide open to collaboration, it's sometimes also unsorted (or sorted in too many various different ways), and with an unpredictable degree of updating. Since the end of 2006, a new effort has been put from Tiki community to have another updated single file for printing (pdf) with all relevant Tiki documentation for 1.9 branch, relative to installation, configuration, features available and tuning process (see Table of contents). Some more pages relative to the new Tikiwiki 1.10.0 have been added already in http://doc.tiki.org. By the time of this writing, this pdf document contained more than 850 numbered and indexed pages, to ease your off-line reading of documentation either in paper or pdf format. Moreover, this allows you make easier and faster searches of information in such a broad amount of pages covering most aspects of Tiki. Current download links (document with 850+ pages)
|
A method for creating current and well organized documentation | |
Despite the chaotic fertility tiki hackers demonstrate at tikiwiki.org, there is a real need for a real classic linear documentation for easy reference. Many tiki contributors asked for a direction where they can help, and the fact is that such collaborative documentation work requires a strong focal point so people can work in effective synchronicity. The Tiki documentation is a collaborative writing project. |
The documentation plan. | |
The secret to a well made wiki is having a logical structure so everybody can figure out the structure of the objects (pages) in the project and process by which they are developed. Document Structure
Anyone who has editing privileges in http://doc.tiki.org can and should edit the table of contents page with the intention of making it better. Documentation Procedure The rules about how to document are controlled by via two important pages: the Style Manual and the Editorial Board. Documentation Status monitors requests for help etc.
example: if the general rule is that an example should appear before the third paragraph, then you could amend the style manual to state that all examples should appear in a text box with "example:" in bold
See: get help From here:
|