Shared open-source style guide

Eric Christensen eric at christensenplace.us
Mon Jun 15 13:50:12 UTC 2009


On Mon, 2009-06-15 at 09:39 -0400, Paul W. Frields wrote:
> 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
> 

Done.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 197 bytes
Desc: This is a digitally signed message part
Url : http://lists.fedoraproject.org/pipermail/docs/attachments/20090615/ac60aaf0/attachment.bin 


More information about the docs mailing list