summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSam Thursfield <sam.thursfield@codethink.co.uk>2018-01-05 11:56:04 +0000
committerSam Thursfield <sam.thursfield@codethink.co.uk>2018-01-05 12:00:01 +0000
commit6636f5a8ede5b1b6204f913260913b9e637bc6da (patch)
tree9bf30d483e45a509f8f25f529b3e33b322b935e2
parentc9551eab009b3493dde8d9a038c1783a5c4c624c (diff)
downloadbuildstream-sam/plugin-docs.tar.gz
doc: Promote documention on how to use external plugins up one levelsam/plugin-docs
Currently the front page at https://buildstream.gitlab.io/buildstream/ doesn't make it easy to discover how to use external plugins. There is an 'External plugins' heading which simply links to the bst-external documentation (which also doesn't document how to use external plugins) and that is all. By promoting the "Plugin Origins and Versions" item up a level, we cause it to appear in the table of contents on the front page making it easier to find.
-rw-r--r--doc/source/projectconf.rst8
1 files changed, 5 insertions, 3 deletions
diff --git a/doc/source/projectconf.rst b/doc/source/projectconf.rst
index c85d3818c..c2741e2ef 100644
--- a/doc/source/projectconf.rst
+++ b/doc/source/projectconf.rst
@@ -79,8 +79,10 @@ with an artifact share.
url: https://foo.com/artifacts
+.. _project_plugins:
+
Plugin Origins and Versions
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
+---------------------------
The BuildStream format is guaranteed to be backwards compatible
with any earlier releases. The core YAML format, the format supported
@@ -96,7 +98,7 @@ Note that elements or plugins with the same name from different origins
are not permitted.
Plugin specification format
-'''''''''''''''''''''''''''
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. code:: yaml
@@ -146,7 +148,7 @@ Plugin specification format
mysource: 0
Project Version Format
-''''''''''''''''''''''
+~~~~~~~~~~~~~~~~~~~~~~
The project's minimum required version of buildstream is specified in
``project.conf`` with the ``format-version`` field, e.g.