Split Up the Readme

[mcrowson]

As zappa's documentation has gotten really big, the readme has grown with it. I suggest having a high level overview with links in the readme, and a link to the complete documentation a-la readthedocs or something similar.

[Miserlou]

Why?

[mcrowson]

Same reason you break any application up as it gets bigger: easier to maintain, consume, and grow.

[collingreen]

Micro Readmes! The real future of development!

[jnlaia]

I think there is one important advantage of having one big readme file: one can search for a string in the entire document and go to the relevant section easily.

[mafrosis]

2 cents: I prefer the single large README

[Miserlou]

Yep, me too. "Just because" isn't a good enough reason for me. Closing to prevent any further bikeshedding.

This, however, still needs to be resolved: #243