initial documentation README

@jonahkagan @rgarcia I think the best way to handle this might be to get feedback on it right now, if this is the style we want for our documentation, and then merge it in to master (still half finished). That way, when we make changes in the future we can update this README as part of those changes. We can also fill in the missing sections while it's in master.

What do you think?