meta-proposal: doc refactor

[jamesturk]

Right now this repo has:

• somewhat halfhearted docs on how cities can adopt OCD as a format
• docs on how to write a scraper with pupa
• somewhat out-of-date descriptions of the various OCD types
• OCDEPs
• a Python style guide

I think in reconsidering the purpose of this repository it should have:

• an intro page explaining what Open Civic Data is, who is involved, etc.
• the canonical docs on each OCD type (updated as amended/created by OCDEPs)
• OCDEPs

The "how cities can adopt OCD" stuff is stale and not worth keeping IMO. If the need arises I imagine we'd take a different approach now than what Sunlight was pursuing when those were started.

And the pupa docs should probably be moved to the pupa repository (& linked from the intro page)

If others are OK with this I'd like to start on this soon so that we can have Open States docs reference good OCD docs where appropriate

[jpmckinney]

Sounds good to me! I only reference the OCDEPs.

[fgregg]

agree!