[OPEN-ILS-DOCUMENTATION] Fwd: Shared open-source style guide

Karen Collier kcollier at kent.lib.md.us
Mon Jun 15 13:36:38 EDT 2009


This sounds like a great idea, and definitely beats reinventing the wheel.  I wonder what their timeline is for putting this together.

Karen Collier

----- "Karen Schneider" <kgs at esilibrary.com> wrote:

> See idea below -- comments to this list (Paul and I will consolidate)
> or to http://writingopensource.com --
> 
> cheers,
> 
> -- 
> -- 
> | Karen G. Schneider
> | Community Librarian
> | Equinox Software Inc. "The Evergreen Experts"
> | Toll-free: 1.877.Open.ILS (1.877.673.6457) x712
> | kgs at esilibrary.com
> | Web: http://www.esilibrary.com
> 
> 
> ---------- Forwarded message ----------
> From: Phil Bull <philbull at gmail.com>
> Date: Sun, Jun 14, 2009 at 5:33 PM
> Subject: Shared open-source style guide
> To: fedora-docs-list at redhat.com, Ubuntu Doc
> <ubuntu-doc at lists.ubuntu.com>, opensuse-doc at opensuse.org,
> gnome-doc-list <gnome-doc-list at gnome.org>, cooker at mandrivalinux.org,
> kde-docbook at kde.org, xfce4-dev at xfce.org, debian-doc at lists.debian.org
> 
> 
> 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.
> 
> Thanks,
> 
> Phil
> 
> [1] - http://writingopensource.com
> [2] - http://writingopensource.com/node/14
> 
> --
> Phil Bull
> https://launchpad.net/people/philbull
> 
> --
> fedora-docs-list mailing list
> fedora-docs-list at redhat.com
> To unsubscribe:
> https://www.redhat.com/mailman/listinfo/fedora-docs-list
> _______________________________________________
> OPEN-ILS-DOCUMENTATION mailing list
> OPEN-ILS-DOCUMENTATION at list.georgialibraries.org
> http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation

-- 
Karen Collier
Public Services Librarian
Kent County Public Library
408 High Street
Chestertown, MD 21620
410-778-3636


More information about the OPEN-ILS-DOCUMENTATION mailing list