<div dir="ltr">I want to discuss the needs for publishing governance documents. I think our requirements start as:<div>- need for a place for review and vote tracking on governance documents</div><div><br></div><div>which this moved some of our documents (reference and resolutions) out of the wiki and into files in an openstack/governance repository.</div>

<div><br></div><div>The requirements for reading those documents seems to be changing, as Sean and others are noting that reading these documents on <a href="http://github.com">github.com</a> or <a href="http://git.openstack.org">git.openstack.org</a> is dissatisfying. So <a href="https://review.openstack.org/#/c/61380/">https://review.openstack.org/#/c/61380/</a> is how Sean is addressing the readability concerns I think. </div>

<div><br></div><div>I think that we need to look at the requirements beyond just reading and into these areas, how will we address:</div><div>- version control (how do I know I'm reading the most recent, can I see the history of changes?)</div>

<div>- history of changes (who made which change when?)</div><div>- discussion outside of <a href="http://review.openstack.org">review.openstack.org</a> from our broad community (offering feedback loops after publishing a resolution)</div>

<div>- search across governance documents (inside site and across all *.<a href="http://openstack.org">openstack.org</a> properties)</div><div>- bug tracking and reporting (offering a feedback loop and ways to track issues and fixes to published content)</div>

<div><br></div><div>I'm reluctant to have these published to <a href="http://docs.openstack.org">docs.openstack.org</a> rather than <a href="http://wiki.openstack.org">wiki.openstack.org</a> because of needing mechanisms to take care of those requirements listed above. I'm bringing it up here to discuss further --- possibly my concerns can be assuaged but I need a discussion outside of the patch at <a href="https://review.openstack.org/#/c/61380/">https://review.openstack.org/#/c/61380/</a> so I can more clearly illustrate my concerns.</div>

<div><br></div><div>To offer two alternative proposals:</div><div>- create a publish-rst-to-openstack-wiki build</div><div>- create governance documents that are authored in a format that then look fine in <a href="https://github.com/openstack/governance/">https://github.com/openstack/governance/</a> or <a href="http://git.openstack.org/cgit/openstack/governance/">http://git.openstack.org/cgit/openstack/governance/</a></div>

<div><br></div><div>Let's take a look at the bigger picture and talk more. </div><div>Thanks,</div><div>Anne </div></div>