search

cncf / tag-security

🔐CNCF Security Technical Advisory Group -- secure access, policy control, privacy, auditing, explainability and more!
https://cncf.io/projects
Other
1.99k stars 496 forks source link

Streamline and update README.md #1273

Closed anvega closed 1 week ago

anvega commented 2 weeks ago

As discussed during the last leads meeting, this PR updates the readme to make it more streamlined and less bloated. Changes include:

These updates aim to provide a more concise and friendly experience for visitors and contributors.

netlify[bot] commented 2 weeks ago

Deploy Preview for tag-security ready!

Name Link
Latest commit c42088484de30a0aa271d35fc0c3a23eef5efea4
Latest deploy log https://app.netlify.com/sites/tag-security/deploys/66739449fb247d00089c56cd
Deploy Preview https://deploy-preview-1273--tag-security.netlify.app
Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

eddie-knight commented 2 weeks ago

I agree with @JustinCappos that a list of publications (especially assessments) is cumbersome on the front page.

anvega commented 2 weeks ago

One of the key principles of intentional Information Architecture is prioritizing the visitor's experience. We need to consider what visitors are looking for and how they can easily find that information, whether through search or navigation.

If someone has heard about an assessment and comes here to find it, having it readily available on the front page allows them to locate it quickly without needing to click through multiple pages or dig for it. More cumbersome is coming to find something quickly and struggling to locate it when it's buried three levels deep.

For visitors who are unaware of the assessments, having a selection of key ones listed on the front page serves as an introduction, showing that these resources exist. Perhaps a good approach is to specify that the listed assessments are selected samples, and provide a note that the complete list can be found in the directory.

anvega commented 1 week ago

I unlisted the assessments from the publication list based on feedback.

eddie-knight commented 1 week ago

Thank you @anvega!