Improve Advanced Usage examples

[lrq3000]

Description:
A few improvement of Advanced Usage examples:

• Rework outputs python-version to replace missing words in description and clarify example.
• Mention '*' for python-version to get the latest stable python release.
• Mention that if statements need to use single-quotes, not double-quotes (and not no-quotes) to test python-version against string literals.

I tried to keep with the conventions used elsewhere in the document, and for my contributions to be as concise as possible (eg, the if statement is not its own paragraph but is just one additional line in the Matrix Testing example, the most relevant one as it's the most common case scenario for an if testing).

Related issue:
Closes #644.

Check list:

• Mark if documentation changes are required.
• Mark if tests were added or updated to cover the changes.

[mahabaleshwars]

Hello @lrq3000,
Thank you for submitting this PR! Could you please update the documentation to reflect the changes to the supported Python versions? Specifically, you need to remove Python 2.7, 3.7, 3.8 and PyPy 2.7 from the documentation, as they are no longer supported by the Python Software Foundation and the broader Python ecosystem.
Additionally, as mentioned earlier, please remove the '*' symbol from the documentation, as it is not recommended.
Furthermore, please update the workflow example as follows:

jobs:
  build:
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        os: [ubuntu-latest, macos-latest, windows-latest]
        python-version: [ '3.9', '3.10', '3.11', 'pypy3.8']
    steps:
      - uses: actions/checkout@v4
      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: ${{ matrix.python-version }}
      - name: Display Python version
        if: ${{ matrix.python-version != 'pypy3.8' }}  # Use single quotes in expressions for input `python-version`
        run: python --version

This update includes:

1. Removing Python 2.7 and PyPy 2.7 from the matrix since they are no longer supported.
2. Changing the Python versions in the matrix to reflect supported versions (3.9, 3.10, 3.11, pypy3.8).
3. Adding an if condition to ensure that the python --version command is not executed for pypy3.8, to account for the fact that pypy handles Python versions differently.

Let me know if you have any questions!

[mahabaleshwars]

Hi lrq3000,

I hope you're doing well! I wanted to check in and see if you've had a chance to go through the feedback comment I left. Please let me know if you need any clarification or further details.

Thanks!

[lrq3000]

@mahabaleshwars Thank you for pinging me, my apologies, I did not see your previous messages. I now have updated my PR according to your suggestions and I have rebased on the latest upstream commit, so you won't have to mergediff.

Note that I slightly modified the example you suggested, as I think it is useful to keep the example excludes, to show how this can be done.

Please feel free to modify the PR further as you see fit.

BTW happy end-of-year celebrations!