[UI/UX support for attestations] Additional Documentation

[kborchers]

• Develop any additional guidance for style guide implementation.
• Develop end user documentation (eg. FAQs, explainers, etc).

[nlhkabu]

re: end user documentation

Our UI audit has identified that we should aim to provide:

• Recommendations specific to PyPIs existing documentation
• Recommendations specific to npm's exisitng documentation
• Recommendations specific to RubyGems existing documentation
• General (summary) recommendations for how to document attestations for end users

I am going to start drafting this content to allow sufficient time for:

1. Review by domain experts (is this documentation accurate?)
2. Testing with end users (does this documentation make sense? Is it easy to find the information I am looking for?)

[nlhkabu]

Final general recommendations attached (as PDF)

best_practices_for_documenting_attestations_in_package_repositories.pdf