summaryrefslogtreecommitdiffstats
path: root/wiki/src
diff options
context:
space:
mode:
authorsajolida <sajolida@pimienta.org>2017-10-10 18:52:20 +0000
committersajolida <sajolida@pimienta.org>2017-10-10 18:52:20 +0000
commit74b593588e5f6dbb4a1f42389bbc24352a43d255 (patch)
tree24fd3b8f528afc9a110f4043981d3dfca1c3a1e9 /wiki/src
parent2045c67843eac3c5da1f215e2ede0f5bd9bf75cd (diff)
parent81e4ce5881bf41107eec425dbf7aa91c952384d7 (diff)
Merge remote-tracking branch 'origin/master'
Diffstat (limited to 'wiki/src')
-rw-r--r--wiki/src/contribute/how/documentation.mdwn26
1 files changed, 26 insertions, 0 deletions
diff --git a/wiki/src/contribute/how/documentation.mdwn b/wiki/src/contribute/how/documentation.mdwn
index a332a4c..1be1b47 100644
--- a/wiki/src/contribute/how/documentation.mdwn
+++ b/wiki/src/contribute/how/documentation.mdwn
@@ -50,6 +50,32 @@ before sharing them with us.
# Tools
+## Find documentation pages impacted by changes in Tails
+
+The `bin/doc-impacted-by` tool takes two "states" (see its `--help`)
+of Tails, and checks the changes between these states against a
+database of relationship between documentation pages and the source
+files and packages impacting them.
+
+The relationships between documentation and source files are stored in
+`doc-source-relationships.yml` in the Git root. It's YAML, and the
+format is something like this:
+
+- The `pages` field is mandatory (after all, we want to find the
+ documentation *pages* that might need to be updated). The remaining
+ fields list source files and packages impacting these pages.
+
+- All fields are interchangeable between the single and plural forms
+ (e.g. `page` is the same as `pages`). Similarly, the values can be
+ either strings, or a lists of strings.
+
+- All string values can use globs and pathspec magic features like
+ `{foo,bar}`.
+
+To use this tools, please first install the dependencies:
+
+ apt install ruby ruby-deep-merge ruby-git ruby-test-unit
+
<a id="compress-image"></a>
## Image compression