Difference between revisions of "Documentation Working Group"

From Joomla! Documentation

m (Adjusted link after page move)
Line 8: Line 8:
 
This entire site is automatically generated by the phpDocumentor package from an analysis of the Joomla! source code and making use of specially formatted comments embedded in the source code itself.  It is an invaluable tool for all Joomla! developers.
 
This entire site is automatically generated by the phpDocumentor package from an analysis of the Joomla! source code and making use of specially formatted comments embedded in the source code itself.  It is an invaluable tool for all Joomla! developers.
 
===[http://docs.joomla.org docs.joomla.org]===
 
===[http://docs.joomla.org docs.joomla.org]===
The concept behind '''docs.joomla.org''' is that it will become the central resource for developing single-source modular documentation within the Joomla! project.  The idea is that we write stuff once then re-use it in a somewhat analogous way to modern OOP software development.  In the future we expect that other sites, such as [http://help.joomla.org help.joomla.org] and [http://developer.joomla.org developer.joomla.org] will contain some, or even most, of their content derived from sources here.  By building a central database of document "chunks" we gain maximum benefit from the efforts of a limited number of authors and we produce "agile" documents where a single change is rapidly propagated to all the derived documents affected.</p><p>Those interested in the techniques will find more information [[Modular Documentation|here]].
+
The concept behind '''docs.joomla.org''' is that it will become the central resource for developing single-source modular documentation within the Joomla! project.  The idea is that we write stuff once then re-use it in a somewhat analogous way to modern OOP software development.  In the future we expect that other sites, such as [http://help.joomla.org help.joomla.org] and [http://developer.joomla.org developer.joomla.org] will contain some, or even most, of their content derived from sources here.  By building a central database of document "chunks" we gain maximum benefit from the efforts of a limited number of authors and we produce "agile" documents where a single change is rapidly propagated to all the derived documents affected.
 +
 
 +
Those interested in the techniques will find more information [[JDOC:Modular documentation|here]].
 
===[http://help.joomla.org help.joomla.org]===
 
===[http://help.joomla.org help.joomla.org]===
 
The official help site houses much of our early documentation, including that for Joomla! 1.0.x, the help screens for all Joomla! versions and the Joomla! 1.5 Installation Guide.
 
The official help site houses much of our early documentation, including that for Joomla! 1.0.x, the help screens for all Joomla! versions and the Joomla! 1.5 Installation Guide.

Revision as of 16:05, 2 February 2011

The Documentation Team is Part of the Production Working Group. It is responsible for creating and maintaining all the official Joomla! documentation including that for end-users, administrators and third-party developers. We also maintain the help screens for the Joomla! releases.

The official documentation language is British/Australian. Translations of the official documentation into other languages are the responsibility of the Translations Working Group.

Websites[edit]

The Documentation Working Group currently maintains the following websites:

api.joomla.org[edit]

This entire site is automatically generated by the phpDocumentor package from an analysis of the Joomla! source code and making use of specially formatted comments embedded in the source code itself. It is an invaluable tool for all Joomla! developers.

docs.joomla.org[edit]

The concept behind docs.joomla.org is that it will become the central resource for developing single-source modular documentation within the Joomla! project. The idea is that we write stuff once then re-use it in a somewhat analogous way to modern OOP software development. In the future we expect that other sites, such as help.joomla.org and developer.joomla.org will contain some, or even most, of their content derived from sources here. By building a central database of document "chunks" we gain maximum benefit from the efforts of a limited number of authors and we produce "agile" documents where a single change is rapidly propagated to all the derived documents affected.

Those interested in the techniques will find more information here.

help.joomla.org[edit]

The official help site houses much of our early documentation, including that for Joomla! 1.0.x, the help screens for all Joomla! versions and the Joomla! 1.5 Installation Guide.

Documentation wiki[edit]

<translate> The bulk of the documentation effort now revolves around this Wiki. </translate> <translate>

  • Please refer to the Docs Wiki Roadmap for a complete overview of tasks.
  • If you are new to MediaWiki you should consult the MediaWiki Handbook for information on using the Wiki software.
  • There are some conventions for making sure the Wiki remains organized.

</translate> <translate>

</translate> <translate>

  • You might want to take a look at

</translate> <translate>

</translate> <translate>

</translate> <translate>

  • Pages that define terms can be added to the Glossary, but not by adding [[Category:Glossary]] to the page. Please see Talk:Glossary for more information.

</translate> <translate>

Internal References[edit]

</translate>{{JDOC:Local wiki references/<translate> en</translate>}}

Other public resources[edit]