Auto-tools/Projects/MozBase: Difference between revisions

Jump to navigation Jump to search
→‎Documentation: Added bullet point about full docs. Removed obsolete reference to docs manifest and MDN
(→‎Documentation: link to page about writing docs)
(→‎Documentation: Added bullet point about full docs. Removed obsolete reference to docs manifest and MDN)
Line 254: Line 254:
=== Documentation ===
=== Documentation ===


* documentation should be in a 'README.md' file in each package's base directory.  The documentation is done in [http://daringfireball.net/projects/markdown/ markdown] syntax so that the it is automatically rendered in the package index presentation on [https://github.com/ github].
* basic documentation should be in a 'README.md' file in each package's base directory.  The documentation is done in [http://daringfireball.net/projects/markdown/ markdown] syntax so that the it is automatically rendered in the package index presentation on [https://github.com/ github].
 
* full docs are found in the [https://github.com/mozilla/mozbase/tree/master/docs top-level docs directory] and hosted at [http://mozbase.readthedocs.org]. We're always looking for help [[Auto-tools/Projects/MozBase/WritingDocs|writing docs]].


* the README.md is included as the `long_description` in each `setup.py` file so that the documentation may be presented (albeit, unrendered) on [http://pypi.python.org/pypi the Python Package Index]. (''Example'': https://github.com/mozilla/mozbase/blob/master/mozprofile/setup.py )
* the README.md is included as the `long_description` in each `setup.py` file so that the documentation may be presented (albeit, unrendered) on [http://pypi.python.org/pypi the Python Package Index]. (''Example'': https://github.com/mozilla/mozbase/blob/master/mozprofile/setup.py )


* [http://k0s.org/mozilla/hg/DocumentIt/ DocumentIt] is used in conjunction with [https://github.com/mozilla/mozbase/blob/master/docs.manifest a manifest] to update documentation on [https://developer.mozilla.org the Mozilla Developer Network (MDN)]. (''TODO'': figure out how to take updates from MDN in a semi-automatic way. Also, since switching to kuma, these documents cannot be mirrored with DocumentIt currently.  Don't even try.)
* [https://wiki.mozilla.org/Auto-tools/Projects/MozBase this page] is the Mozbase project page that gives information for core Mozbase Developers and about the project itself.  Documentation may move to and from this page and the various README files
 
* [https://wiki.mozilla.org/Auto-tools/Projects/MozBase this page] is the MozBase project page that gives information for core MozBase Developers and about the project itself.  Documentation may move to and from this page and the various README files
 
* We're always looking for help [[Auto-tools/Projects/MozBase/WritingDocs|writing docs]].


=== Directory Structure and Imports ===
=== Directory Structure and Imports ===
Confirmed users
1,927

edits

Navigation menu