search

18F / archived-guides

A collection of 18F guides.
https://guides.18f.gov
Other
20 stars 12 forks source link

Guides governance and process #33

Open coreycaitlin opened 8 years ago

coreycaitlin commented 8 years ago

Given the proliferation of guides, it's easy for the guides page to be overwhelming. One thing that would help is to introduce a very light governance process so that we don't add guides to the left-nav until they're ready for broader reading. That is, we shouldn't be linking to guides that are very rough drafts or WIP from this page.

It seems fine for guides to mainly exist on GitHub while in progress.

Any objections? What would we want that lightweight process to look like? Should it include any approvals, or just a note about the guide being at v1 + names of people or guilds who will contribute to maintaining it?

wslack commented 8 years ago

I think this is our current tentative process, albeit informal? We didn't link the Partnership Playbook immediately. I would defer to @mtorres253 and @mbland as to a governance process to get listed on the main guides sidebar.

mbland commented 8 years ago

Yes, something very light like this should get codified. I think we'll need to get resolution on #31 and #32 first, though.