Fix some small things

[cmarqu]

I want to go over the file once more still.

@stevepiercy I'd appreciate if you could also take another look as you did for the domain-specific files (thanks for that).

[stevepiercy]

I made some grammar corrections, but also some suggestions for improving presentation. We could add sphinx-examples, but not in this PR, to get a further improved presentation.

[stevepiercy]

LGTM. Thank you!

[stevepiercy]

OK, now I really approve. 😉

[stevepiercy]

@cmarqu would you please create issues for each of these todos to give them greater visibility, then remove them here?

[stevepiercy]

@cmarqu I just realized that you need to edit https://github.com/sphinx-themes/sphinx-themes.org/blob/master/src/templates/conf.template.py#L32-L34 as shown below, else :py:keyword:`async` won't render at build time.

intersphinx_mapping = {
    "python": ("https://docs.python.org/3/", None),
    "sphinx": ("https://www.sphinx-doc.org/en/master/", None),
}

[cmarqu]

@cmarqu I just realized that you need to edit https://github.com/sphinx-themes/sphinx-themes.org/blob/master/src/templates/conf.template.py#L32-L34 as shown below, else :py:keyword:`async` won't render at build time.

Oh, right... so many things that play together.

[stevepiercy]

Third time's the charm!