The Docs team has been working on a spec for an overhaul of our formal project documentation, and the spec has been posted for review.  You can find it at https://review.openstack.org/#/c/635641.  Feedback and comments graciously accepted!

      brucej