summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAnastasia Klimchuk <aklm@flashrom.org>2024-02-19 19:48:04 +1100
committerAnastasia Klimchuk <aklm@chromium.org>2024-02-23 01:44:26 +0000
commit49fbdc7dd61a6add01e2de56e379fda54823cbab (patch)
treea76a714b85e01e8e3ed07ef6d5dc64afde2c17f2
parent8b074c8b7c1aeaf3f80a6ba20a6df1d1b8ee6ec5 (diff)
downloadflashrom-49fbdc7dd61a6add01e2de56e379fda54823cbab.tar.gz
flashrom-49fbdc7dd61a6add01e2de56e379fda54823cbab.tar.bz2
flashrom-49fbdc7dd61a6add01e2de56e379fda54823cbab.zip
doc: Clarify that adding docs follows dev process and add into howtos
Also add link to "How to add new doc" into a collection of Contributors howtos. The doc stays in root of docs, and also in the main left-side menu on the website, so that it is very easy to discover. Everyone who has even the slightest motivation to update the docs, should be able to find instructions easily. Change-Id: I882de0614ab76b8e83b0fafa67296526fecd8a16 Signed-off-by: Anastasia Klimchuk <aklm@flashrom.org> Reviewed-on: https://review.coreboot.org/c/flashrom/+/80631 Tested-by: build bot (Jenkins) <no-reply@coreboot.org> Reviewed-by: Stefan Reinauer <stefan.reinauer@coreboot.org>
-rw-r--r--doc/contrib_howtos/index.rst1
-rw-r--r--doc/how_to_add_docs.rst5
2 files changed, 6 insertions, 0 deletions
diff --git a/doc/contrib_howtos/index.rst b/doc/contrib_howtos/index.rst
index 59326cd68..b33482da4 100644
--- a/doc/contrib_howtos/index.rst
+++ b/doc/contrib_howtos/index.rst
@@ -7,3 +7,4 @@ Contributors howtos
how_to_add_new_chip
how_to_mark_chip_tested
how_to_add_unit_test
+ ../how_to_add_docs
diff --git a/doc/how_to_add_docs.rst b/doc/how_to_add_docs.rst
index 0b32acbd2..ee99ce71c 100644
--- a/doc/how_to_add_docs.rst
+++ b/doc/how_to_add_docs.rst
@@ -1,6 +1,11 @@
How to add or update docs
=========================
+Documentation files live in ``/doc`` directory in the source tree, so
+adding or updating documentation follows the same process as changing
+the code. If you've never done it before, start by carefully
+reading the :doc:`/dev_guide/development_guide`.
+
To add or update a documentation page, you need to create or modify
an ``.rst`` file in the ``/doc`` directory and send a patch for
review.