From e60c9d753cd7cda3df1492cee949a88c7713fb9b Mon Sep 17 00:00:00 2001 From: Quentin Schulz Date: Wed, 18 Jun 2025 17:13:36 +0200 Subject: document how to use :doc: directive Let's specify that we are only expecting "absolute" paths in the docs directive for local document referencing. (From yocto-docs rev: 2729250bf1068814e5106d1e71796e8a505963d7) Signed-off-by: Quentin Schulz Signed-off-by: Antonin Godard Signed-off-by: Richard Purdie --- documentation/standards.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) (limited to 'documentation/standards.md') diff --git a/documentation/standards.md b/documentation/standards.md index 8300d813dc..801efe3457 100644 --- a/documentation/standards.md +++ b/documentation/standards.md @@ -126,7 +126,16 @@ that most themes only style these two admonitions. ## ReStructured Text Syntax standards -This section has not been filled yet +### doc directive + +The [doc directive](https://www.sphinx-doc.org/en/master/usage/referencing.html#role-doc) +allows to refer to another document within yocto-docs, like: + + For more information, read :doc:`/bsp-guide/index`. + +Note that only "absolute" paths (starting with a '/') are allowed. The root +directory of that path is documentation/, that is, :doc:`/bsp-guide/index` +points at documentation/bsp-guide/index.rst. ## Adding screenshots -- cgit v1.2.3-54-g00ecf