Documentation Working Group/Websites/en: Difference between revisions

From Joomla! Documentation

FuzzyBot (talk | contribs)
Importing a new version from external source
 
FuzzyBot (talk | contribs)
Updating to match new version of source page
 
(6 intermediate revisions by the same user not shown)
Line 9: Line 9:
===[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.
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.  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 [[S:MyLanguage/JDOC:Modular documentation|here]].
Those interested in the techniques will find more information [[S:MyLanguage/JDOC:Modular documentation|here]].


===[http://help.joomla.org help.joomla.org]===
Those of you, who are not very experienced in image editing and might want to improve the quality of their screenshots should read the tutorial [[S:MyLanguage/Taking_Screenshots_–_How_To_Enhance|Taking Screenshots – How To Enhance]].


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.
[[S:MyLanguage/Help screens|Joomla! help screens]] are created on this wiki and are shown in the backend of any Joomla! website from here.
* [[Help screens|Joomla! 1.5.x help screens]] are created on this wiki before being moved to [http://help.joomla.org/content/section/42/278/ help.joomla.org]
* [http://help.joomla.org/content/section/16/276/ Joomla! 1.0.x help screens]  Note: These are no longer being maintained.
* [[Creating a Joomla! 1.5 help screens SQL dump]]
* [http://joomlacode.org/gf/project/joomla/docman/?subdir=6 Help screens SQL dump files] for Joomla! versions up to 1.5.x.


[[Category:Documentation Working Group]]
[[Category:Documentation Working Group]]

Latest revision as of 14:50, 19 July 2021

The Documentation Working Group currently maintains the following websites:

api.joomla.org

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

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. 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.

Those of you, who are not very experienced in image editing and might want to improve the quality of their screenshots should read the tutorial Taking Screenshots – How To Enhance.

Joomla! help screens are created on this wiki and are shown in the backend of any Joomla! website from here.