[SeasonOfDocs] Information Architecture

[Cameron Shorter]

Jo, I suspect it might be easiest to bootstrap your ideas in a Google 
doc that you share and get comments. It is quick and dirty and can be 
thrown away after a few weeks.


On 11/7/19 6:17 pm, Jo Cook wrote:
> Hi Cameron,
>
> I really meant temporary repositories for information while we get 
> things up and running. If we start with the website structure, IMHO we 
> have to decide on how that's going to work before we can think about 
> getting any content in. My thought was just to get *something* in 
> place that's publicly accessible (for, say, licensing discussions) and 
> then move to sorting out the website and the official structure of the 
> project when we've had time to think things through properly.
>
> Regards
>
> Jo
>
> On Wed, Jul 10, 2019 at 9:15 PM Cameron Shorter 
> <cameron.shorter at gmail.com <mailto:cameron.shorter at gmail.com>> wrote:
>
>     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.
>
>     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.
>
>     If we continue to align ourselves with WriteTheDocs, as we are
>     considering, we should also consider how we fit within
>     https://www.writethedocs.org/
>
>     So I'm thinking our structure could be:
>
>     WriteTheDocs Website
>
>     + <other WriteTheDocs pages>
>
>     + *WriteTheDocsGuide / TheGoodDocsProject* -> external link to our
>     guide.writethedocs.org <http://guide.writethedocs.org> or similar
>
>     ++ Index.html (introduction and jump page)
>
>     ++ Community/
>
>     +++ CodeOfConduct.html
>
>     +++ Governance.html (our decision making processes)
>
>     +++ DevelopmentProcess.html (This is likely big enough to be split
>     out from Governance)
>
>     +++ CommunicatonChannels.html (how we talk with each other and how
>     to get involved)
>
>     ...
>
>     ++ Templates/
>
>     +++ Quickstart/
>
>     +++ Template.html
>
>     +++ Guide.html (how to use the guide)
>
>     +++ Background.html (Where we discuss metadata concepts and
>     research about the Quickstart)
>
>     ...
>
>     ++ Information Architecture
>
>     +++ <site wide information architecture theory>
>
>     +++ StarRatingSystem.html (Not sure if this deserves it's own
>     directory)
>
>
>     On 11/7/19 2:28 am, Jo Cook wrote:
>>     Hi Felicity,
>>
>>     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:
>>
>>     * governance- for holding (for now) the Code of Conduct, details
>>     of PSC, licensing discussions etc
>>     * planning- for my nascent document on project structure
>>     * website
>>
>>     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.
>>
>>     Thoughts?
>>
>>     Jo
>>
>     -- 
>     Cameron Shorter
>     Technology Demystifier
>     Open Technologies and Geospatial Consultant
>
>     M +61 (0) 419 142 254
>
>     _______________________________________________
>     SeasonOfDocs mailing list
>     SeasonOfDocs at lists.osgeo.org <mailto:SeasonOfDocs at lists.osgeo.org>
>     https://lists.osgeo.org/mailman/listinfo/seasonofdocs
>
>
>
> -- 
> ------------------------
> http://about.me/jocook

-- 
Cameron Shorter
Technology Demystifier
Open Technologies and Geospatial Consultant

M +61 (0) 419 142 254

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/seasonofdocs/attachments/20190711/31d15bc6/attachment.html>