DokuWiki

It's better when it's simple

User Tools

Site Tools


teams:documentation

Documentation Team

The Documentation Team has the primary focus on improving and complementing the DokuWiki documentation

What are the main Tasks?

The user manual is always in need of wiki gardening. Even if you only have used DokuWiki for a short time there is much to do.

General wiki gardening

  • Improve documentation and FAQs where people complain about unclear stuff
  • Add more links where needed, e.g. Include Hooks
  • Correct spelling mistakes
  • Keep pages tidy (especially plugins). There are often comments. Most of them should be removed and merged into the documentation part of the pages and in comprehensive FAQs.
  • Translate pages to your local language
  • Make and add screenshots of features or plugins where appropriate
  • Search for FIXME, try to fix them

Keep up with development

  • Make sure the documentation is up to date.
  • Monitor development changes and ensure that the necessary documentation is created (or extended) by the developers in a comprehensible way. Some organization below.
  • Closed bugs with the tag “ToDo: needDocUpdate” need improvements of the documentation. For example: adding the new syntax, removing old bug reports or workarounds. (Add the [[devel:develonly]] link when features are not yet released).
  • There are some documentation pages which mention that certain DokuWiki features are devel:develonly (use the backlinks feature to find them). If these remarks are less recent than the most recent release, they are most probably no longer relevant. Check that and remove them and rewrite the affected paragraphs.
  • Maintain also the tags experimental, devel:deprecated and devel:adoption

Plugins & Templates

Specific sections

  • are all pages in :tips namespace linked?
  • check devel: pages for updates, refresh examples

Additional syntax dokuwiki.org

For useful non-default syntax see additional syntax.

Who we are?

  • Scott Hewitt
  • Barry Coughlan
  • Chris Green
teams/documentation.txt · Last modified: 2023-10-25 00:17 by Klap-in

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki