<div dir="ltr">Hey Folks<div><br></div><div>We've been talking a lot about working in the open, and we are 99% through approving a number of documents, and to be honest, I'm finding it very hard to keep up with where we're at on a lot of them.</div><div><br></div><div>I'd like to propose something, just as a discussion point for now, but what I'm proposing is that we do policy documents as markdown documents in a Git repository.</div><div><br></div><div>There's a few reasons why this is good, and some that may make it unfeasible.</div><div><br></div><div>The good:</div><div><ul><li>We have one repository of documents</li><li>There's versioning, so you can see the history of changes</li><li>We make it open with an open license</li><li>It's easily discoverable</li><li>Changes can be made in a pull request and discussed and iterated there</li></ul><div>The bad:</div><div><ul><li>It's a technical solution, and still requires us to write documents</li><li>It is an impediment to editing documents, as some find it hard.</li></ul><div>Just a thought...</div></div><div><br></div><div>Cheers,</div><div><div><br></div>-- <br><div dir="ltr" class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div>Alex Leith<br></div>m: 0419189050</div></div></div></div></div>