diff --git a/.gitignore b/.gitignore index f5d95de96a..da5e5ff60a 100644 --- a/.gitignore +++ b/.gitignore @@ -1,4 +1,5 @@ venv +docs/venv # Ignores CPython checkout cpython diff --git a/docs/bumping-release.rst b/docs/bumping-release.rst index f49d094c0b..9fa55ce169 100644 --- a/docs/bumping-release.rst +++ b/docs/bumping-release.rst @@ -1,13 +1,17 @@ -==================================================== +:orphan: + +============================================== Bumping python-newest to latest Python release -==================================================== +============================================== + +.. warning:: -NOTE: This doc is out of date and needs rework! The -`pull request \#13 `_ -is a work in progress that would change some instructions from this guide. + This doc is out of date and needs rework! The + `pull request \#13 `_ + is a work in progress that would change some instructions from this guide. -This document aims to list the steps required for updating version of the 'Python' -project (slug 'python-newest) in python-doc organization in Transifex. +This document aims to list the steps required for bumping the version of the +'Python' project (slug 'python-newest) in the python-doc organization on Transifex. 1. Back up current translations: diff --git a/docs/commands.rst b/docs/commands.rst index d5dcde157a..914720fc00 100644 --- a/docs/commands.rst +++ b/docs/commands.rst @@ -88,6 +88,7 @@ For language teams that coordinate translation efforts on Transifex, updating translation means pulling the translation strings. .. admonition:: Recommendation + Before pulling translations, consider updating the .tx/config to have an up-to-date mapping of project/resources. For this, it is required to generate the documentation's pot files (template of po files), so start diff --git a/docs/conf.py b/docs/conf.py index b4fc062057..9040ecf2c1 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -7,22 +7,22 @@ # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information project = "Python Docs Transifex Automations" -copyright = "2025, rffontenelle" -author = "rffontenelle" +copyright = "2025, rffontenelle and StanFromIreland" +author = "rffontenelle and StanFromIreland" # -- General configuration --------------------------------------------------- # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration extensions = [] -templates_path = ["_templates"] -exclude_patterns = [] +templates_path = [] +exclude_patterns = ["venv", ".venv"] # -- Options for HTML output ------------------------------------------------- # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output html_theme = "furo" -html_static_path = ["_static"] +html_static_path = [] html_title = "Python Docs Transifex Automations" # ----------------------------------------------------------------------------