GSA / cto-website

Tech at GSA website
https://tech.gsa.gov/
Other
47 stars 65 forks source link

Guide framework/structure #52

Closed jfredrickson5 closed 8 years ago

jfredrickson5 commented 8 years ago

Restructure the Guides section so that guides are divided into categories. Those categories can be based on role. Example: https://www.gov.uk/service-manual

jfredrickson5 commented 8 years ago

I'm thinking that each guide can have "category" and "audience" metadata fields. Each guide can have multiple audience types. I also think that initially each guide should only fit into one category, though it'd certainly be possible to assign a guide to multiple categories.

This will allow us to primarily organize the guides into categories, while also allowing us to highlight useful guides for specific audiences.

Possible categories, along with example guide topics:

Possible audiences:

jcastle-zz commented 8 years ago

The structure looks good. I would stay away from "governance" as it connotes something legacy. We can come up with a different name.

For now, we can have placeholder links for all of the categories and roles and then work to build them out.

afeld commented 8 years ago

The information architecture is far from perfect, but here is @18F's list:

https://pages.18f.gov/guides/