From 893cb293fcaa1e60cc75f168c5d3f477129daa9a Mon Sep 17 00:00:00 2001 From: jiceatscion <139873336+jiceatscion@users.noreply.github.com> Date: Wed, 24 Jul 2024 16:34:44 +0200 Subject: [PATCH] doc: add a WIP section to the index (#4583) It is not possible to build without error in the presence of a document that is not in the index. In order for CS not to fail for PRs that include a new, not-yet-approved doc, adding an index section where they can be safely linked. See: https://github.com/scionproto/scion/pull/4560#issuecomment-2205915862 --- doc/dev/design/index.rst | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/doc/dev/design/index.rst b/doc/dev/design/index.rst index 6a28e80404..3633cd6721 100644 --- a/doc/dev/design/index.rst +++ b/doc/dev/design/index.rst @@ -8,7 +8,8 @@ See section :ref:`change-proposal-process` for the overview on the overall contribution process. - **Creation**: - Design documents are created from the template :file-ref:`doc/dev/design/TEMPLATE.rst`. + Design documents are created from the template :file-ref:`doc/dev/design/TEMPLATE.rst`. While the design is still being discussed, it is linked in the + section :ref:`design-docs-wip` Once discussion on a change proposal converges and a design document is approved, it is inserted to section :ref:`design-docs-active`. @@ -30,6 +31,13 @@ contribution process. a useful reference for the current system, it moves to section :ref:`design-docs-outdated`. +.. _design-docs-wip: + +WIP +=== +.. toctree:: + :maxdepth: 1 + .. _design-docs-active: Active