[SeasonOfDocs] Motion: adopt a style guide

[Stephanie Blotner]

Yes! This is a motion to use Google Developer Documentation Style Guide
<https://developers.google.com/style/> with the Merriam-Webster
<https://www.merriam-webster.com/>dictionary

On Wed, Aug 7, 2019 at 11:47 AM Clarence Cromwell <
clarencewcromwell at gmail.com> wrote:

> That might be a worthy alternative. Is this a motion, and if so, what
> dictionary would go with it?
>
> Sent from my iPhone
>
> On Aug 7, 2019, at 11:43 AM, Stephanie Blotner <sblotner59 at gmail.com>
> wrote:
>
> What about the Google Developer Documentation Style Guide
> <https://developers.google.com/style/>?
>
> On Wed, Aug 7, 2019 at 9:20 AM Clarence Cromwell <
> clarencewcromwell at gmail.com> wrote:
>
>> I move that we adopt the Microsoft Style Guide
>> <https://docs.microsoft.com/en-us/style-guide/welcome/> and the Merriam-Webster
>> <https://www.merriam-webster.com/>dictionary for The Good Docs project,
>> and that we apply them to whatever writing is generated by the project (our
>> web site and our official templates) but that we don't demand that anyone
>> use a guide for contributing a collection of templates, as they are source
>> material.
>>
>> (I would emphasize that we only have to apply the style guide to material
>> before we publish it, so that doesn't even require that people learn it
>> before contributing; anyone who doesn't have the time, could allow an
>> editor to clean up contributions according to the style guide.)
>>
>> Reasoning:
>>
>>    - We need to all work from a single standard.
>>    - These guides are available for free online.
>>    - The Microsoft Guide is specific to technical writing, and is widely
>>    accepted in the industry.
>>
>> If there are strong feelings about using a different guide, I would
>> suggest a counter-motion naming a specific set of books, so that people can
>> vote for one or the other, and then we can get on with business.
>> _______________________________________________
>> SeasonOfDocs mailing list
>> SeasonOfDocs at lists.osgeo.org
>> https://lists.osgeo.org/mailman/listinfo/seasonofdocs
>>
>
>
> --
> Stephanie Blotner
>
>

-- 
Stephanie Blotner
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/seasonofdocs/attachments/20190807/f1b49fba/attachment.html>