[SeasonOfDocs] Style guides

Jennifer Rondeau jennifer.rondeau at gmail.com
Mon Aug 5 05:57:32 PDT 2019


Some of this work is already done elsewhere, exhaustively:
https://www.writethedocs.org/guide/writing/style-guides/

On Mon, Aug 5, 2019 at 7:13 AM Cameron Shorter <cameron.shorter at gmail.com>
wrote:

> If we are to "do the hard work to make things simple", then we should help
> a new project embrace a well know and widely adopted style guide.
>
> Distill the numerous existing options down to a small subset of
> favourites, and then provide a clear decision tree for selecting one over
> the other. This would be a very valuable task for the greater community -
> although it would likely be a lot of work to take it through to completion.
>
> I'm not sure if anyone is ready to pick up this task yet?
>
>
> On 5/8/19 12:57 pm, Clarence Cromwell wrote:
>
> There was mention of style guides and American English versus UK English
> in the comments on Google docs.
>
> It might be early to make a motion, but I'd like to know what people
> think.
>
> I would be inclined to use the Merriam-Webster Dictionary and the latest
> Microsoft Style Guide, because they are both available online and free.
> Also the MS is ideal for technical writing.
>
> In the SF Bay Area, there's a strong bias towards American English.
> :- )
>
>
>
> _______________________________________________
> SeasonOfDocs mailing listSeasonOfDocs at lists.osgeo.orghttps://lists.osgeo.org/mailman/listinfo/seasonofdocs
>
> --
> Cameron Shorter
> Technology Demystifier
> Open Technologies and Geospatial Consultant
>
> M +61 (0) 419 142 254
>
> _______________________________________________
> SeasonOfDocs mailing list
> SeasonOfDocs at lists.osgeo.org
> https://lists.osgeo.org/mailman/listinfo/seasonofdocs
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/seasonofdocs/attachments/20190805/1f82e365/attachment-0001.html>


More information about the SeasonOfDocs mailing list