governance: Use links to inlined policies, #1038

open-contracting · Jun 20, 2023 · eb36f8f · eb36f8f
1 parent 94e518f
commit eb36f8f
Show file tree

Hide file tree

Showing 11 changed files with 29 additions and 29 deletions.
diff --git a/docs/governance/index.md b/docs/governance/index.md
@@ -54,7 +54,7 @@ The revision process is designed to ensure:
 
 Changes to the OCDS schema will be made periodically, with the version number of the standard incremented to indicate that changes have been made, and a changelog maintained.
 
-This documentation website is composed of normative content (the prescriptive part of OCDS) and non-normative content (the non-prescriptive, or ‘descriptive’, part of OCDS) as defined and described in the [Normative and non-normative content and changes policy](https://docs.google.com/document/d/1xjlAneqgewZvHh6_hwuQ98hbjxRcA2IUqOTJiNGcOf8/edit). This policy establishes which changes to which parts of the documentation must involve the revision process described below (e.g. adding new fields to the release schema), and which changes may be made without the revision process (e.g. correcting typos in field descriptions, or updating implementation guidance).
+This documentation website is composed of normative content (the prescriptive part of OCDS) and non-normative content (the non-prescriptive, or ‘descriptive’, part of OCDS) as defined and described in the [Normative and non-normative content and changes policy](normative). This policy establishes which changes to which parts of the documentation must involve the revision process described below (e.g. adding new fields to the release schema), and which changes may be made without the revision process (e.g. correcting typos in field descriptions, or updating implementation guidance).
 
 ### Versions
 
@@ -164,7 +164,7 @@ If a term (a definition or field) is scheduled to be renamed or removed from the
 
 ## Translation and localization policy
 
-The standard is translated and localized in line with the [latest version of the translation and localization policy](https://docs.google.com/document/d/1GLwWTpgDDkKmMr1hZE4D75LI8VQtFiD0VA7TF_FvY_Q/view). 
+The standard is translated and localized in line with the [latest version of the translation and localization policy](translation).
 
 ## Support policy
 

diff --git a/docs/guidance/map/localization.md b/docs/guidance/map/localization.md
@@ -73,7 +73,7 @@ Refer to the [extensions documentation](extensions) for more information on usin
 
 ## Translating the standard
 
-The OCDS standard development team maintains *supported* translations according to the [translation and localization policy](../../governance/index.md#translation-and-localization-policy). Volunteers contribute *community* translations.
+The OCDS standard development team maintains *supported* translations according to the [translation and localization policy](../../governance/translation). Volunteers contribute *community* translations.
 
 If the standard is not yet available in your language, you can propose a new translation of the schema and documentation, or collaborate on an existing community translation.
 

diff --git a/docs/history/changelog.md b/docs/history/changelog.md
@@ -4,7 +4,7 @@ These release notes describe what's new in each version. OCDS adheres to [Semant
 
 ## Iterative improvements
 
-Per the [normative and non-normative content and changes policy](https://docs.google.com/document/d/1xjlAneqgewZvHh6_hwuQ98hbjxRcA2IUqOTJiNGcOf8/edit), iterative improvements to non-normative content can be made outside the release cycle.
+Per the [normative and non-normative content and changes policy](../governance/normative), iterative improvements to non-normative content can be made outside the release cycle.
 
 ### Documentation
 
@@ -276,7 +276,7 @@ Per the [normative and non-normative content and changes policy](https://docs.go
 
 ## [1.1.5] - 2020-08-20
 
-* [#1054](https://github.com/open-contracting/standard/pull/1054) The [Translation and localization policy](../governance/index.md#translation-and-localization-policy) is amended to read "normative content will be translated into all core supported languages *as soon as possible*" instead of "*before the release*". A Spanish translation is ready for release, and a French translation will be ready as soon as possible.
+* [#1054](https://github.com/open-contracting/standard/pull/1054) The [Translation and localization policy](../governance/translation) is amended to read "normative content will be translated into all core supported languages *as soon as possible*" instead of "*before the release*". A Spanish translation is ready for release, and a French translation will be ready as soon as possible.
 
 ### Codelists
 
@@ -333,8 +333,8 @@ See the changelogs for:
  * **Action:** If you had upgraded to OCDS 1.1.3, then compiled releases and versioned releases that set `Item.unit` will likely need to be re-created to validate against the OCDS 1.1.4 schema.
 * [#810](https://github.com/open-contracting/standard/pull/810) `buyer.id`, `Tender.procuringEntity.id`, `Contract.implementation.payer.id` `Contract.implementation.payee.id`, `Budget.id`, `Identifier.id`, and `Classification.id` are now versioned, consistent with the documentation.
  * **Action:** Versioned releases that set these fields will likely need to be re-created to validate against the OCDS 1.1.4 schema.
-* [#831](https://github.com/open-contracting/standard/pull/831) OCDS now has a [Normative and non-normative content and changes policy](https://docs.google.com/document/d/1xjlAneqgewZvHh6_hwuQ98hbjxRcA2IUqOTJiNGcOf8/edit).
-* [#744](https://github.com/open-contracting/standard/pull/744) OCDS now has a [Translation and localization policy](../governance/index.md#translation-and-localization-policy).
+* [#831](https://github.com/open-contracting/standard/pull/831) OCDS now has a [Normative and non-normative content and changes policy](../governance/normative).
+* [#744](https://github.com/open-contracting/standard/pull/744) OCDS now has a [Translation and localization policy](../governance/translation).
 * [#717](https://github.com/open-contracting/standard/pull/717) [#734](https://github.com/open-contracting/standard/pull/734) The OCDS documentation website now has a privacy notice.
 * The documentation is now available in Italian.
 

diff --git a/docs/index.md b/docs/index.md
@@ -2,7 +2,7 @@
 
 ````{ifconfig} language and language not in ('en', 'es', 'fr')
 ```{note}
-This is a [community translation](https://docs.google.com/document/d/1GLwWTpgDDkKmMr1hZE4D75LI8VQtFiD0VA7TF_FvY_Q/view) of OCDS carried out by [ TRANSLATORS ].
+This is a [community translation](governance/translation) of OCDS carried out by [ TRANSLATORS ].
 ```
 ````
 

diff --git a/docs/locale/es/LC_MESSAGES/governance/index.po b/docs/locale/es/LC_MESSAGES/governance/index.po
@@ -317,7 +317,7 @@ msgid ""
 "prescriptive part of OCDS) and non-normative content (the non-prescriptive, "
 "or ‘descriptive’, part of OCDS) as defined and described in the [Normative "
 "and non-normative content and changes "
-"policy](https://docs.google.com/document/d/1xjlAneqgewZvHh6_hwuQ98hbjxRcA2IUqOTJiNGcOf8/edit)."
+"policy](normative)."
 " This policy establishes which changes to which parts of the documentation "
 "must involve the revision process described below (e.g. adding new fields to"
 " the release schema), and which changes may be made without the revision "
@@ -328,7 +328,7 @@ msgstr ""
 "parte prescriptiva de OCDS) y contenido no-normativo (la parte no-"
 "prescriptiva, o ‘descriptiva’ de OCDS) como se define y describe en la "
 "[Política de Contenido y Cambios Normativos y No "
-"Normativos](https://docs.google.com/document/d/1xjlAneqgewZvHh6_hwuQ98hbjxRcA2IUqOTJiNGcOf8/edit)."
+"Normativos](normative)."
 " Esta política establece qué cambios a qué partes de la documentación deben "
 "de involucrar el proceso de revisión descrito más abajo (ej. añadir nuevos "
 "campos al esquema de entrega), y qué cambios pueden hacerse sin el proceso "
@@ -745,11 +745,11 @@ msgstr "Políticas de traducción y localización"
 msgid ""
 "The standard is translated and localized in line with the [latest version of"
 " the translation and localization "
-"policy](https://docs.google.com/document/d/1GLwWTpgDDkKmMr1hZE4D75LI8VQtFiD0VA7TF_FvY_Q/view)."
+"policy](translation)."
 msgstr ""
 "El estándar se traduce y se localiza en línea con la [última versión de la "
 "política de traducción y "
-"localización](https://docs.google.com/document/d/1GLwWTpgDDkKmMr1hZE4D75LI8VQtFiD0VA7TF_FvY_Q/view)."
+"localización](translation)."
 
 #: ../../docs/governance/index.md:163
 msgid "Support policy"

diff --git a/docs/locale/es/LC_MESSAGES/guidance/map/localization.po b/docs/locale/es/LC_MESSAGES/guidance/map/localization.po
@@ -343,7 +343,7 @@ msgstr "Traducción del estándar"
 msgid ""
 "The OCDS standard development team maintains *supported* translations "
 "according to the [translation and localization "
-"policy](../../governance/index.md#translation-and-localization-policy). "
+"policy](../../governance/translation). "
 "Volunteers contribute *community* translations."
 msgstr ""
 "El equipo de desarrollo del estándar de OCDS mantiene las traducciones "

diff --git a/docs/locale/es/LC_MESSAGES/history/changelog.po b/docs/locale/es/LC_MESSAGES/history/changelog.po
@@ -47,12 +47,12 @@ msgstr "Mejoras iterativas"
 #: ../../docs/history/changelog.md:7
 msgid ""
 "Per the [normative and non-normative content and changes "
-"policy](https://docs.google.com/document/d/1xjlAneqgewZvHh6_hwuQ98hbjxRcA2IUqOTJiNGcOf8/edit),"
+"policy](../governance/normative),"
 " iterative improvements to non-normative content can be made outside the "
 "release cycle."
 msgstr ""
 "De acuerdo a la [política de cambios y contenido normativo y no-"
-"normativo](https://docs.google.com/document/d/1xjlAneqgewZvHh6_hwuQ98hbjxRcA2IUqOTJiNGcOf8/edit),"
+"normativo](../governance/normative),"
 " las mejoras iterativas a contenido no-normativo puede hacerse fuera del "
 "ciclo de entrega."
 
@@ -919,11 +919,11 @@ msgstr ""
 msgid ""
 "[#831](https://github.com/open-contracting/standard/pull/831) OCDS now has a"
 " [Normative and non-normative content and changes "
-"policy](https://docs.google.com/document/d/1xjlAneqgewZvHh6_hwuQ98hbjxRcA2IUqOTJiNGcOf8/edit)."
+"policy](../governance/normative)."
 msgstr ""
 "[#831](https://github.com/open-contracting/standard/pull/831) OCDS ahora "
 "tiene una [Política de Contenido y Cambios Normativos y No "
-"Normativos](https://docs.google.com/document/d/1xjlAneqgewZvHh6_hwuQ98hbjxRcA2IUqOTJiNGcOf8/edit)"
+"Normativos](../governance/normative)"
 " (en inglés)."
 
 #: ../../docs/history/changelog.md:128
@@ -934,7 +934,7 @@ msgid ""
 msgstr ""
 "[#744](https://github.com/open-contracting/standard/pull/744) OCDS ahora "
 "tiene una [Política de Traducción y "
-"Localización](../governance/index.md#translation-and-localization-policy)."
+"Localización](../governance/translation)."
 
 #: ../../docs/history/changelog.md:129
 msgid ""

diff --git a/docs/locale/fr/LC_MESSAGES/governance/index.po b/docs/locale/fr/LC_MESSAGES/governance/index.po
@@ -300,7 +300,7 @@ msgid ""
 "prescriptive part of OCDS) and non-normative content (the non-prescriptive, "
 "or ‘descriptive’, part of OCDS) as defined and described in the [Normative "
 "and non-normative content and changes "
-"policy](https://docs.google.com/document/d/1xjlAneqgewZvHh6_hwuQ98hbjxRcA2IUqOTJiNGcOf8/edit)."
+"policy](normative)."
 " This policy establishes which changes to which parts of the documentation "
 "must involve the revision process described below (e.g. adding new fields to"
 " the release schema), and which changes may be made without the revision "
@@ -311,7 +311,7 @@ msgstr ""
 "normative d’OCDS) et d’un contenu non normatif (la partie non normative ou "
 "«descriptive» d’OCDS) tels que définis et décrits dans ce document (en "
 "anglais) [Contenu normatif et non normatif et politique de "
-"modifications](https://docs.google.com/document/d/1xjlAneqgewZvHh6_hwuQ98hbjxRcA2IUqOTJiNGcOf8/edit)."
+"modifications](normative)."
 " Cette politique détermine quelles modifications venant de quelles parties "
 "de la documentation doivent déclencher le processus de révision décrit ci-"
 "dessous (par exemple, l'ajout de nouveaux champs au schéma de version), et "
@@ -725,11 +725,11 @@ msgstr "Politique de traduction et de localisation"
 msgid ""
 "The standard is translated and localized in line with the [latest version of"
 " the translation and localization "
-"policy](https://docs.google.com/document/d/1GLwWTpgDDkKmMr1hZE4D75LI8VQtFiD0VA7TF_FvY_Q/view)."
+"policy](translation)."
 msgstr ""
 "Le standard est traduit et localisé conformément à la [dernière version de "
 "la politique de traduction et de "
-"localisation](https://docs.google.com/document/d/1GLwWTpgDDkKmMr1hZE4D75LI8VQtFiD0VA7TF_FvY_Q/view)."
+"localisation](translation)."
 " "
 
 #: ../../docs/governance/index.md:163

diff --git a/docs/locale/fr/LC_MESSAGES/guidance/map/localization.po b/docs/locale/fr/LC_MESSAGES/guidance/map/localization.po
@@ -249,7 +249,7 @@ msgstr ""
 msgid ""
 "The OCDS standard development team maintains *supported* translations "
 "according to the [translation and localization "
-"policy](../../governance/index.md#translation-and-localization-policy). "
+"policy](../../governance/translation). "
 "Volunteers contribute *community* translations."
 msgstr ""
 

diff --git a/docs/locale/fr/LC_MESSAGES/history/changelog.po b/docs/locale/fr/LC_MESSAGES/history/changelog.po
@@ -44,12 +44,12 @@ msgstr "Améliorations itératives"
 #: ../../docs/history/changelog.md:7
 msgid ""
 "Per the [normative and non-normative content and changes "
-"policy](https://docs.google.com/document/d/1xjlAneqgewZvHh6_hwuQ98hbjxRcA2IUqOTJiNGcOf8/edit),"
+"policy](../governance/normative),"
 " iterative improvements to non-normative content can be made outside the "
 "release cycle."
 msgstr ""
 "D'après [notre politique sur le contenu normatif et non-normatif et les "
-"changements](https://docs.google.com/document/d/1xjlAneqgewZvHh6_hwuQ98hbjxRcA2IUqOTJiNGcOf8/edit),"
+"changements](../governance/normative),"
 " des amélioration itératives sur du contenu non-normatif peuvent être "
 "effectuées en dehors du cycle de publication."
 
@@ -717,11 +717,11 @@ msgstr ""
 msgid ""
 "[#831](https://github.com/open-contracting/standard/pull/831) OCDS now has a"
 " [Normative and non-normative content and changes "
-"policy](https://docs.google.com/document/d/1xjlAneqgewZvHh6_hwuQ98hbjxRcA2IUqOTJiNGcOf8/edit)."
+"policy](../governance/normative)."
 msgstr ""
 "[#831](https://github.com/open-contracting/standard/pull/831) OCDS a "
 "désormais une [Politique sur les contenus et changements normatifs et non-"
-"normatifs](https://docs.google.com/document/d/1xjlAneqgewZvHh6_hwuQ98hbjxRcA2IUqOTJiNGcOf8/edit)."
+"normatifs](../governance/normative)."
 
 #: ../../docs/history/changelog.md:127
 msgid ""
@@ -731,7 +731,7 @@ msgid ""
 msgstr ""
 "[#744](https://github.com/open-contracting/standard/pull/744) OCDS a "
 "désormais [Une politique de traduction et de "
-"localisation](../governance/index.md#translation-and-localization-policy)."
+"localisation](../governance/translation)."
 
 #: ../../docs/history/changelog.md:128
 msgid ""

diff --git a/manage.py b/manage.py
@@ -793,7 +793,7 @@ def add_translation_notes():
  the updates are released. The documentation will clearly display when the English documentation is 'ahead' of
  translations for a particular version."
 
- https://standard.open-contracting.org/1.1/en/governance/#translation-and-localization-policy
+ https://standard.open-contracting.org/latest/en/governance/translation/
  """
  excluded = ('.doctrees', '_downloads', '_images', '_sources', '_static', 'codelists', 'genindex', 'search')