aboutsummaryrefslogtreecommitdiffstats
path: root/Bugzilla
diff options
context:
space:
mode:
authorGervase Markham <gerv@gerv.net>2015-01-07 16:02:52 +0000
committerGervase Markham <gerv@gerv.net>2015-01-07 16:02:52 +0000
commit4e15a1338ccc68b44a6fbf26a2c57b46b00df4ce (patch)
treefc110497311895c3bd235ad16ea18167de7b66b9 /Bugzilla
parent40a522aabc8a48f0813c6b69404e466606384db8 (diff)
downloadbugs-4e15a1338ccc68b44a6fbf26a2c57b46b00df4ce.tar
bugs-4e15a1338ccc68b44a6fbf26a2c57b46b00df4ce.tar.gz
bugs-4e15a1338ccc68b44a6fbf26a2c57b46b00df4ce.tar.bz2
bugs-4e15a1338ccc68b44a6fbf26a2c57b46b00df4ce.tar.xz
bugs-4e15a1338ccc68b44a6fbf26a2c57b46b00df4ce.zip
Bug 1107549 - split extension docs into User and Admin docs. r=dkl, a=glob.
Diffstat (limited to 'Bugzilla')
-rw-r--r--Bugzilla/Extension.pm15
1 files changed, 15 insertions, 0 deletions
diff --git a/Bugzilla/Extension.pm b/Bugzilla/Extension.pm
index 17193f1b6..e24ceb9eb 100644
--- a/Bugzilla/Extension.pm
+++ b/Bugzilla/Extension.pm
@@ -651,6 +651,21 @@ So, for example, if you had a CSS file called F<style.css> and your
extension was called F<Foo>, your file would go into
F<extensions/Foo/web/style.css>.
+=head2 Documenting Extensions
+
+Documentation goes in F<extensions/Foo/docs/en/rst/>, if it's in English, or
+change "en" to something else if it's not. The user documentation index file
+must be called index-user.rst; the admin documentation must be called
+index-admin.rst. These will end up in the User Guide and the Administration
+Guide respectively. Both documentation types are optional. You can use various
+Sphinx constructs such as :toctree: or :include: to include further reST files
+if you need more than one page of docs.
+
+When documenting extensions to the Bugzilla API, if your extension provides
+them, the index file would be F<extensions/Foo/docs/en/rst/api/v1/index.rst>.
+When and if your API has more than one version, increment the version number.
+These docs will get included in the WebService API Reference.
+
=head2 Disabling Your Extension
If you want your extension to be totally ignored by Bugzilla (it will