From a48cc6b4958ef19784866c92a67ca4898adf9367 Mon Sep 17 00:00:00 2001 From: Christian Flothmann Date: Thu, 1 Oct 2015 19:26:01 +0200 Subject: [PATCH] translations have been removed from symfony.com --- contributing/documentation/index.rst | 6 +- contributing/documentation/overview.rst | 7 +- contributing/documentation/translations.rst | 85 +-------------------- contributing/map.rst.inc | 1 - 4 files changed, 8 insertions(+), 91 deletions(-) diff --git a/contributing/documentation/index.rst b/contributing/documentation/index.rst index 08782431605..e3711184813 100644 --- a/contributing/documentation/index.rst +++ b/contributing/documentation/index.rst @@ -7,5 +7,9 @@ Contributing Documentation overview format standards - translations license + +.. toctree:: + :hidden: + + translations diff --git a/contributing/documentation/overview.rst b/contributing/documentation/overview.rst index fd101ae7d08..9255a68935a 100644 --- a/contributing/documentation/overview.rst +++ b/contributing/documentation/overview.rst @@ -294,11 +294,6 @@ Please be patient. It can take up to several days before your pull request can be fully reviewed. After merging the changes, it could take again several hours before your changes appear on the symfony.com website. -What If I Want to Translate Some Documentation into my Language? -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Read the dedicated :doc:`document `. - Why Should I Use the Oldest Maintained Branch Instead of the Master Branch? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -345,4 +340,4 @@ definitely don't want you to waste your time! .. _SensioLabsConnect: https://connect.sensiolabs.com/ .. _`Symfony Documentation Badge`: https://connect.sensiolabs.com/badge/36/symfony-documentation-contributor .. _`sync your fork`: https://help.github.com/articles/syncing-a-fork -.. _`Platform.sh`: https://platform.sh \ No newline at end of file +.. _`Platform.sh`: https://platform.sh diff --git a/contributing/documentation/translations.rst b/contributing/documentation/translations.rst index 73779ba3afa..12ed91071a5 100644 --- a/contributing/documentation/translations.rst +++ b/contributing/documentation/translations.rst @@ -1,87 +1,6 @@ Translations ============ -The Symfony documentation is written in English and many people are involved -in the translation process. +Featuring translations of the Symfony documentation `has been terminated`_. -.. note:: - - Symfony Project officially discourages from starting new translations for the - documentation. As a matter of fact, there is `an ongoing discussion`_ in - the community about the benefits and drawbacks of community driven translations. - -Contributing ------------- - -First, become familiar with the :doc:`markup language ` -used by the documentation. - -Finally, find the *master* repository for the language you want to contribute -for. Here is the list of the official *master* repositories: - -* *English*: https://github.com/symfony/symfony-docs -* *French*: https://github.com/symfony-fr/symfony-docs-fr -* *Italian*: https://github.com/garak/symfony-docs-it -* *Japanese*: https://github.com/symfony-japan/symfony-docs-ja -* *Portuguese (Brazilian)*: https://github.com/andreia/symfony-docs-pt-BR - -.. note:: - - If you want to contribute translations for a new language, read the - :ref:`dedicated section `. - -Joining the Translation Team ----------------------------- - -If you want to help translating some documents for your language or fix some -bugs, consider joining us; it's a very easy process: - -* *(optional)* Ask which documents you can work on; -* Fork the *master* repository for your language (click the "Fork" button on - the GitHub page); -* Translate some documents; -* Ask for a pull request (click on the "Pull Request" from your page on - GitHub); -* The team manager accepts your modifications and merges them into the master - repository; -* The documentation website is updated every other night from the master - repository. - -.. _translations-adding-a-new-language: - -Adding a new Language ---------------------- - -This section gives some guidelines for starting the translation of the -Symfony documentation for a new language. - -As starting a translation is a lot of work, try to find motivated people -willing to help. - -When the team is ready, nominate a team manager; they will be responsible for -the *master* repository. - -Create the repository and copy the *English* documents. - -The team can now start the translation process. - -When the team is confident that the repository is in a consistent and stable -state (everything is translated, or non-translated documents have been removed -from the toctrees -- files named ``index.rst`` and ``map.rst.inc``), the team -manager can ask that the repository is added to the list of official *master* -repositories by sending an email to Fabien (fabien at symfony.com). - -Maintenance ------------ - -Translation does not end when everything is translated. The documentation is a -moving target (new documents are added, bugs are fixed, paragraphs are -reorganized, ...). The translation team need to closely follow the English -repository and apply changes to the translated documents as soon as possible. - -.. caution:: - - Non maintained languages are removed from the official list of - repositories as obsolete documentation is dangerous. - -.. _`an ongoing discussion`: https://github.com/symfony/symfony-docs/issues/4078 +.. _`has been terminated`: http://symfony.com/blog/discontinuing-the-symfony-community-translations diff --git a/contributing/map.rst.inc b/contributing/map.rst.inc index 22c759821e4..9ec7f507ab0 100644 --- a/contributing/map.rst.inc +++ b/contributing/map.rst.inc @@ -17,7 +17,6 @@ * :doc:`Overview ` * :doc:`Format ` * :doc:`Documentation Standards ` - * :doc:`Translations ` * :doc:`License ` * **Community**