From 64c28cbad27b9631165e23efdccd5f1f8ca378b5 Mon Sep 17 00:00:00 2001 From: Jos Poortvliet Date: Wed, 19 Jan 2022 15:36:53 +0100 Subject: [PATCH] Update README.rst --- README.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/README.rst b/README.rst index 4d874b5cc..02b94b72f 100644 --- a/README.rst +++ b/README.rst @@ -47,6 +47,16 @@ Source files are written using the `Sphinx Documentation Generator `_ style, and can also be edited from GitHub. +Structure +--------- + +Of course, think about structure. Keep in mind that we try NOT to move or rename +pages once they are created! Lots of external sources link to our documentation, +including the indexing by Google of course. So once you create a page with a certain +name, it has to stay in that location and with that name. Think of it as API stability +- we have to ensure things stay as they are as much as possible. Renaming or moving +is only allowed in exceptional circumstances and only when a redirect is put in place. + Editing -------