Links to PyPI, newlines after headings, build and contribute section improvements

Author: m-aciek

README.en.md

@@ -27,7 +27,8 @@ f'''[![build](https://github.com/python/python-docs-pl/actions/workflows/update-
 
 ### How do I check what needs translating?
 
-Use the `potodo` package. Run it in the project's root directory, for example: `uvx potodo`.
+Use the [`potodo`](https://pypi.org/project/sphinx-lint/) package. Run it in the project's root directory,
+for example: `uvx potodo`.
 
 If you are interested in the core articles, use filtering. For example:
 
@@ -49,9 +50,7 @@ Suggested priority resources for translation can be found in [issue #50](https:/
 * Create an account on Transifex.
 * Select Polish on the project page.
 * After submitting your request to join the team, introduce yourself on the [Python Polska #dokumentacja Discord channel](https://discord.gg/QB3h2Sxc). This will help us approve your request sooner.
-* After joining the team, select the resource you want to improve or update.
-
-You can find more information about using Transifex
+* After joining the team, select the resource you want to improve or update.  You can find more information about using Transifex
 in [their help articles](https://help.transifex.com/en/articles/6318216-translating-with-the-web-editor) or [our guide](https://python-docs-transifex-automation.readthedocs.io/new-translators.html).
 
 ### How do I check my changes locally?
@@ -73,7 +72,7 @@ python-newest.library--turtle [pl] - Done
 [##############################] (1 / 1)
 ```
 
-Run `sphinx-lint` to check your changes, for example:
+Run [`sphinx-lint`](https://pypi.org/project/sphinx-lint/) to check your changes, for example:
 
 ```
 $ uvx sphinx-lint library/turtle.po
@@ -88,12 +87,7 @@ The documentation at https://docs.python.org/pl/ is updated around once daily.
 
 ### How do I build the documentation?
 
-You need a checkout of the CPython repository to build the documentation.
-
-Create a symbolic link (Unix) or a copy (Windows) of the `python-docs-pl` project in the CPython repository's
-`Doc/locales/pl` directory, named `LC_MESSAGES`.
-
-Then run `make -C Doc SPHINXOPTS="-D language=pl" html` in the CPython repository to build the documentation.
+[See devguide's instructions.](https://devguide.python.org/documentation/translations/translating/#how-do-i-build-a-docs-translation)
 
 ### Communication channels
 
@@ -119,16 +113,19 @@ In return, it will be visible that you are the translator of the part you transl
 You signify your acceptance of this agreement by submitting your work for inclusion in the documentation.
 
 ### Repository updates
+
 * `./manage_translation.py recreate_tx_config`
 * `./manage_translation.py fetch`
 * `cog -rP README.en.md`
 
 ### Useful materials
+
 * [Python Developer's Guide: Translating](https://devguide.python.org/documentation/translations/translating/)
 * [Python docs Transifex: Documentation](https://python-docs-transifex-automation.readthedocs.io/)
 * [Site Statistics](https://analytics.python.org/docs.python.org?f=contains,page,/pl/)
 
 ### Similar projects
+
 * [Projects of the Python Packaging Authority](https://hosted.weblate.org/projects/pypa/-/pl/)
 * [Scientific Python Translations](https://scientific-python-translations.github.io/)
 * [micro:bit translation programme](https://microbit.org/translate/)

README.md

@@ -27,7 +27,8 @@ f'''[![build](https://github.com/python/python-docs-pl/actions/workflows/update-
 
 ### Jak sprawdzić, co jest do przetłumaczenia?
 
-Służy do tego paczka `potodo`. Wywołaj ją w głównym katalogu projektu, np. `uvx potodo`.
+Służy do tego paczka [`potodo`](https://pypi.org/project/potodo/). Wywołaj ją w głównym katalogu projektu,
+na przykład `uvx potodo`.
 
 Jeżeli interesują cię podstawowe artykuły, użyj filtrowania. Przykład:
 
@@ -50,9 +51,7 @@ projektu [dokumentacji Pythona](https://explore.transifex.com/python-doc/python-
 * Utwórz konto Transifex.
 * Na stronie projektu wybierz język polski.
 * Po wysłaniu zgłoszenia do zespołu przedstaw się na kanale [Discord Python Polska #dokumentacja](https://discord.gg/QB3h2Sxc). Pozwoli to szybciej potwierdzić Twoje zgłoszenie.
-* Po dołączeniu do zespołu wybierz zasób, który chcesz poprawić/zaktualizować.
-
-Więcej informacji o używaniu Transifeksa znajdziesz w
+* Po dołączeniu do zespołu wybierz zasób, który chcesz poprawić/zaktualizować. Więcej informacji o używaniu Transifeksa znajdziesz w
 [jego artykułach pomocy](https://help.transifex.com/en/articles/6318216-translating-with-the-web-editor) lub [w naszym przewodniku](https://python-docs-transifex-automation.readthedocs.io/new-translators.html).
 
 ### Jak lokalnie sprawdzić poprawność moich zmian?
@@ -74,7 +73,7 @@ python-newest.library--turtle [pl] - Done
 [##############################] (1 / 1)
 ```
 
-Uruchom `sphinx-lint`, aby sprawdzić poprawność zmian, np.:
+Uruchom [`sphinx-lint`](https://pypi.org/project/sphinx-lint/), aby sprawdzić poprawność zmian, na przykład:
 
 ```
 $ uvx sphinx-lint library/turtle.po
@@ -91,8 +90,8 @@ Dokumentacja na https://docs.python.org/pl/ aktualizowana jest około raz dzienn
 
 Aby zbudować dokumentację potrzebujesz mieć kopię repozytorium CPythona.
 
-Zrób link symboliczny (Unix) lub kopię (Windows) projektu `python-docs-pl` w katalogu `Doc/locales/pl` repozytorium
-CPython, o nazwie `LC_MESSAGES`.
+Zrób link symboliczny (Unix) lub kopię (Windows) zawartości projektu `python-docs-pl` w katalogu
+`Doc/locales/pl/LC_MESSAGES` w repozytorium CPython.
 
 Następnie uruchom `make -C Doc SPHINXOPTS="-D language=pl" html` w projekcie CPython, aby zbudować dokumentację.
 
@@ -120,16 +119,19 @@ W zamian będzie widoczne, że jesteś tłumaczem(-ką) części, którą przet
 Wyrażasz akceptację tej umowy, przesyłając swoją pracę do włączenia do dokumentacji.
 
 ### Aktualizacje w repozytorium
+
 * `./manage_translation.py recreate_tx_config`
 * `./manage_translation.py fetch`
 * `cog -rP README.md`
 
 ### Przydatne materiały
+
 * [Python Developer's Guide: Translating](https://devguide.python.org/documentation/translations/translating/)
 * [Python docs Transifex: Documentation](https://python-docs-transifex-automation.readthedocs.io/)
 * [statystyki oglądalności](https://analytics.python.org/docs.python.org?f=contains,page,/pl/)
 
 ### Podobne projekty
+
 * [projekty Python Packaging Authority](https://hosted.weblate.org/projects/pypa/-/pl/)
 * [Scientific Python Translations](https://scientific-python-translations.github.io/)
 * [micro:bit translation programme](https://microbit.org/translate/)