LGTM from user's perspective.

Also clears up how the "don't save your token in plaintext" wizardry works

To see the rendered version without building locally, check out:

https://bhrutledge-ppug.bhrutledge.now.sh/specifications/pypirc.html

Thank you for the extra mile!

Also in-line rendering looks good enough to get rendered text display

@di I hope you'll forgive the nudge, but I'd appreciate your thoughts on this before I link to it from other parts of the guide. And, ultimately, it'd be nice to resolve pypa/twine#638.

@bhrutledge On my list for today.

For reference, here is the distutils documentation about .pypirc before it was deleted from the CPython repo: https://github.com/python/cpython/blob/v3.4.10/Doc/distutils/packageindex.rst#the-pypirc-file

For reference, here is the distutils documentation about .pypirc before it was deleted from the CPython repo

Thanks! I actually started with that, then updated/expanded it.

Any other @pypa/packaging-user-guide-editors want to review?