docs: Improve contributing docs (#5708)

CONTRIBUTING.md

+<!--
+The content of this file is manually kept in sync with docs/contributing.md. There are formatting differences because this file uses plain markdown.
+-->
+
 # Contributing to Poetry
 # Contributing to Poetry
 
 
 First off, thanks for taking the time to contribute!
 First off, thanks for taking the time to contribute!
@@ -104,11 +108,13 @@ the code base, join us on our [Discord Server](https://discordapp.com/invite/awx
 
 
 You will need Poetry to start contributing on the Poetry codebase. Refer to the [documentation](https://python-poetry.org/docs/#introduction) to start using Poetry.
 You will need Poetry to start contributing on the Poetry codebase. Refer to the [documentation](https://python-poetry.org/docs/#introduction) to start using Poetry.
 
 
+> **Note:** Local development of Poetry requires Python 3.8 or newer.
+
 You will first need to clone the repository using `git` and place yourself in its directory:
 You will first need to clone the repository using `git` and place yourself in its directory:
 
 
 ```bash
 ```bash
-$ git clone git@github.com:python-poetry/poetry.git
-$ cd poetry
+git clone git@github.com:python-poetry/poetry.git
+cd poetry
 ```
 ```
 
 
 > **Note:** We recommend that you use a personal [fork](https://docs.github.com/en/free-pro-team@latest/github/getting-started-with-github/fork-a-repo) for this step. If you are new to GitHub collaboration,
 > **Note:** We recommend that you use a personal [fork](https://docs.github.com/en/free-pro-team@latest/github/getting-started-with-github/fork-a-repo) for this step. If you are new to GitHub collaboration,
@@ -118,15 +124,15 @@ Now, you will need to install the required dependency for Poetry and be sure tha
 tests are passing on your machine:
 tests are passing on your machine:
 
 
 ```bash
 ```bash
-$ poetry install
-$ poetry run pytest tests/
+poetry install
+poetry run pytest tests/
 ```
 ```
 
 
 Poetry uses [mypy](https://github.com/python/mypy) for typechecking, and the CI
 Poetry uses [mypy](https://github.com/python/mypy) for typechecking, and the CI
 will fail if it finds any errors.  To run mypy locally:
 will fail if it finds any errors.  To run mypy locally:
 
 
 ```bash
 ```bash
-$ poetry run mypy
+poetry run mypy
 ```
 ```
 
 
 Poetry uses the [black](https://github.com/psf/black) coding style and you must ensure that your
 Poetry uses the [black](https://github.com/psf/black) coding style and you must ensure that your
@@ -139,13 +145,13 @@ To make sure that you don't accidentally commit code that does not follow the co
 install a pre-commit hook that will check that everything is in order:
 install a pre-commit hook that will check that everything is in order:
 
 
 ```bash
 ```bash
-$ poetry run pre-commit install
+poetry run pre-commit install
 ```
 ```
 
 
 You can also run it anytime using:
 You can also run it anytime using:
 
 
 ```bash
 ```bash
-$ poetry run pre-commit run --all-files
+poetry run pre-commit run --all-files
 ```
 ```
 
 
 Your code must always be accompanied by corresponding tests, if tests are not present your code
 Your code must always be accompanied by corresponding tests, if tests are not present your code

docs/contributing.md

@@ -9,6 +9,10 @@ menu:
     weight: 100
     weight: 100
 ---
 ---
 
 
+<!--
+The content of this file is manually kept in sync with ../CONTRIBUTING.md. There are formatting differences because this file uses Hugo templating.
+-->
+
 # Contributing to Poetry
 # Contributing to Poetry
 
 
 First off, thanks for taking the time to contribute!
 First off, thanks for taking the time to contribute!
@@ -119,11 +123,15 @@ the code base, join us on our [Discord Server](https://discordapp.com/invite/awx
 
 
 You will need Poetry to start contributing on the Poetry codebase. Refer to the [documentation](https://python-poetry.org/docs/#introduction) to start using Poetry.
 You will need Poetry to start contributing on the Poetry codebase. Refer to the [documentation](https://python-poetry.org/docs/#introduction) to start using Poetry.
 
 
+{{% note %}}
+Local development of Poetry requires Python 3.8 or newer.
+{{% /note %}}
+
 You will first need to clone the repository using `git` and place yourself in its directory:
 You will first need to clone the repository using `git` and place yourself in its directory:
 
 
 ```bash
 ```bash
-$ git clone git@github.com:python-poetry/poetry.git
-$ cd poetry
+git clone git@github.com:python-poetry/poetry.git
+cd poetry
 ```
 ```
 
 
 {{% note %}}
 {{% note %}}
@@ -135,15 +143,15 @@ Now, you will need to install the required dependency for Poetry and be sure tha
 tests are passing on your machine:
 tests are passing on your machine:
 
 
 ```bash
 ```bash
-$ poetry install
-$ poetry run pytest tests/
+poetry install
+poetry run pytest tests/
 ```
 ```
 
 
 Poetry uses [mypy](https://github.com/python/mypy) for typechecking, and the CI
 Poetry uses [mypy](https://github.com/python/mypy) for typechecking, and the CI
 will fail if it finds any errors.  To run mypy locally:
 will fail if it finds any errors.  To run mypy locally:
 
 
 ```bash
 ```bash
-$ poetry run mypy
+poetry run mypy
 ```
 ```
 
 
 Poetry uses the [black](https://github.com/psf/black) coding style and you must ensure that your
 Poetry uses the [black](https://github.com/psf/black) coding style and you must ensure that your
@@ -156,13 +164,13 @@ To make sure that you don't accidentally commit code that does not follow the co
 install a pre-commit hook that will check that everything is in order:
 install a pre-commit hook that will check that everything is in order:
 
 
 ```bash
 ```bash
-$ poetry run pre-commit install
+poetry run pre-commit install
 ```
 ```
 
 
 You can also run it anytime using:
 You can also run it anytime using:
 
 
 ```bash
 ```bash
-$ poetry run pre-commit run --all-files
+poetry run pre-commit run --all-files
 ```
 ```
 
 
 Your code must always be accompanied by corresponding tests, if tests are not present your code
 Your code must always be accompanied by corresponding tests, if tests are not present your code