<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body text="#000000" bgcolor="#FFFFFF">
<p>Jo, I think this doc structure idea is important enough to break
into a new email thread and get it's own title. I'm hoping to see
ideas debated here.<br>
</p>
<p>I'm erring toward thinking that all our material should fit
within a website folder. Also, I'm not sure planning deserves it's
own folder. Instead I'm thinking it should just be thought of as a
development branch of all the content.</p>
<p>If we continue to align ourselves with WriteTheDocs, as we are
considering, we should also consider how we fit within <a
href="https://www.writethedocs.org/">https://www.writethedocs.org/</a></p>
<p>So I'm thinking our structure could be:</p>
<p>WriteTheDocs Website</p>
<p>+ <other WriteTheDocs pages></p>
<p>+ <b>WriteTheDocsGuide / TheGoodDocsProject</b> -> external
link to our guide.writethedocs.org or similar</p>
<p>++ Index.html (introduction and jump page)</p>
<p>++ Community/</p>
<p>+++ CodeOfConduct.html</p>
<p>+++ Governance.html (our decision making processes)</p>
<p>+++ DevelopmentProcess.html (This is likely big enough to be
split out from Governance)<br>
</p>
<p>+++ CommunicatonChannels.html (how we talk with each other and
how to get involved)<br>
</p>
<p> ...<br>
</p>
<p>++ Templates/</p>
<p>+++ Quickstart/</p>
<p>+++ Template.html</p>
<p>+++ Guide.html (how to use the guide)<br>
</p>
<p>+++ Background.html (Where we discuss metadata concepts and
research about the Quickstart)</p>
<p>...</p>
<p>++ Information Architecture</p>
<p>+++ <site wide information architecture theory></p>
<p>+++ StarRatingSystem.html (Not sure if this deserves it's own
directory)<br>
</p>
<p><br>
</p>
<div class="moz-cite-prefix">On 11/7/19 2:28 am, Jo Cook wrote:<br>
</div>
<blockquote type="cite"
cite="mid:CAMM8GAv06TCVm9-NU4nRzepgnk2fnTBfO5ad6tk9LR3Ta=TBbw@mail.gmail.com">
<div>Hi Felicity,</div>
<div><br>
</div>
<div>Thanks for taking notes- it looks good to me. I was also
thinking about getting some proto-repositories going on github-
with suggested headings of:</div>
<div><br>
</div>
<div>* governance- for holding (for now) the Code of Conduct,
details of PSC, licensing discussions etc<br>
</div>
<div>* planning- for my nascent document on project structure<br>
</div>
<div>* website</div>
<div><br>
</div>
<div>That way we can use the wikis in the various repositories for
some of our discussion documents rather than google docs. I
still like the idea of google docs for the first-pass
collaborative commenting on quick starts though.</div>
<div><br>
</div>
<div>Thoughts?</div>
<div><br>
</div>
<div>Jo<br>
</div>
<div><br>
</div>
</blockquote>
<pre class="moz-signature" cols="72">--
Cameron Shorter
Technology Demystifier
Open Technologies and Geospatial Consultant
M +61 (0) 419 142 254</pre>
</body>
</html>