fix: enhance existing authentication docs

[lwasser]

closes #821

This is a small update to the authentication page. it adds

✅ subheadings for easier skimming
✅ a breakout on 2FA as requested in #821
✅ a bit of clarification throughout.

I have two significant questions.

1. like others mentioned in that 821 i found that even with my username stores in the toml file, hatch still asked for it.
2. The order of precedence for username vs password is different in this file. I didn't touch this but i wonder if that is actually the case?

IN other words, if i just enter credentials manually using -u and-auth will hatch still try to override with the .pypirc file if it finds it? i'm now convinced that order is actually correct but i also haven't dug into the code yet.

[pitrou]

Suggested change

	2. a token value or other form of trusted authentication from the index (PyPI)
	2. a password, token value or other form of trusted authentication for the package index

[pitrou]

Hi @lwasser , I just posted a couple of comments in the hope of making the help more explicit and easier to understand. Feel free to approve these changes or not :)

[funkyfuture]

(how) is this related to the proposed prose changes?

[lwasser]

hey @funkyfuture i mentioned this to @ofek right now the docs won't build without this change in the hatch doc environment. I read it's a known issue. I think ofek wants to make the change separately / rebuild the environment. But if anyone wants to pull this down and build they will have issues without this change (or atleast that is what i discovered).

[cjames23]

@lwasser Can you address the docs build failure and I can work on getting this merged in.