zephyr/doc/contribute
David B. Kinder 486c5a54e5 doc: add doc writing guides w/common usages
I've collected some of the common issues encountered with doc reviews
into a new contributing document, and included use of the
Zephyr-specific extension for generating code building examples.

Updated conf.py and created an external list of substitutions making it
easier to manage them without editing the sphinx conf file (and
documented this).

Tweaked the comments in the application.py extension python code to
render better in the generated doc that extracts these comments (keeps
the documentation in the python code too to ease maintenance when
updates are made).

Updated the sample template to mention use of this sphinx extension.

fixes: #6831
fixes: #6811

Signed-off-by: David B. Kinder <david.b.kinder@intel.com>
2018-05-11 09:09:49 -07:00
..
code_component_README doc: add contributing non-Apache2.0 docs 2017-09-22 08:39:38 -04:00
contribute.rst doc: add doc writing guides w/common usages 2018-05-11 09:09:49 -07:00
contribute_guidelines.rst
contribute_non-apache.rst doc: fix links to mailing lists 2018-04-21 06:55:46 -07:00
doc-guidelines.rst doc: add doc writing guides w/common usages 2018-05-11 09:09:49 -07:00