Shared open-source style guide

Paul W. Frields stickster at gmail.com
Mon Jun 15 13:39:23 UTC 2009


On Sun, Jun 14, 2009 at 10:33:00PM +0100, Phil Bull wrote:
> Hi guys,
> 
> An idea was floated at WOSCON [1] to create a shared open-source style
> guide for documentation writers [2]. This would be a "vanilla" style
> guide, which projects could modify and extend if necessary. Advantages
> include:
> 
>       * No need for projects to write their own style guide from scratch
>       * Reasonable uniformity in style and terminology across projects
>       * Independence from external style guides, which may cost money to
>         access
>       * Projects which don't have a style guide get one for free
> 
> We have people from GNOME, Ubuntu, Xfce and Drupal discussing this right
> now, and we'd love for other projects to let us know if they are
> interested in the concept, and to give us their feedback if they are.
> 
> PLEASE get in touch via the WOS website [1] rather than replying
> directly to this message, since this is getting crossposted to a lot of
> doc lists.
> 
> [1] - http://writingopensource.com
> [2] - http://writingopensource.com/node/14

Eric,

Can we add this to the meeting agenda for this week?  I'd suggest
that someone take the action item of bringing our Style Guide to the
WOS folks since it's free for them to use and remix.  It may only be a
starting point, but should be somewhat helpful.

-- 
Paul W. Frields                                http://paul.frields.org/
  gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233  5906 ACDB C937 BD11 3717
  http://redhat.com/   -  -  -  -   http://pfrields.fedorapeople.org/
  irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug




More information about the docs mailing list