dash-docs/docs/contributing-to-developer-documentation.md
2018-01-25 14:49:26 +00:00

1.6 KiB

Developer Documentation

Most parts of the documentation can be found in the _includes directory. Updates, fixes and improvements are welcome and can submitted using pull requests on GitHub.

Style Guide: For better consistency, the style guide can be used as a reference for terminology, style and formatting. Suggested changes can also be submitted to this guide to keep it up to date.

Cross-Reference Links: Cross-reference links can be defined in _includes/references.md. Terms which should automatically link to these references are defined in _autocrossref.yaml .

New Glossary Entries

Add new English glossary entries in the _data/glossary/en/ directory. Copy a previous glossary entry to get the correct YAML variables (suggest using block.yaml as a template).

Non-English glossary entries are not currently supported. You'll have to update the glossary.rb plugin and templates to support them.

New Developer Search terms

You can add new search terms or categories directly to the devsearches array in _config.yaml. Comments in that file should provide full documentation.