[OPEN-ILS-DOCUMENTATION] Documentation style proposal

Karen Schneider kgs at esilibrary.com
Wed Jan 14 17:10:42 EST 2009


Dear folks, Betty Ing, a documentation intern at Project Conifer, has
published a comparison of Style Guidelines for Fedora and Book of Evergreen.
For those who missed her post (to the documentation list) I published her
cross-walk here:

http://spreadsheets.google.com/pub?key=pqvVF5hSEbDO6MlrXHXxDUg

Betty said, "I would suggest adopting Fedora (it has addressed many
multilingual concerns) and including a style sheet to supplement Fedora in
areas where there was additional guidance from Evergreen. In this way, a
potential documentation contributor would only need to consult Fedora and a
style sheet, which we can continue to update as required. Please have a look
at the attached spreadsheet and provide any feedback by Tues. Jan. 20, if
possible."

The larger proposal she refers to I just slapped up in GDocs. It had been
making the rounds of various stakeholders in the Evergreen community, but
since she mentions it I might as well roll it out:

http://docs.google.com/Doc?id=ddzqk523_264f2vk5vpn

Note that there are any kind of top-level decisions to be made, and it's not
even a given we call the documentation The Book of Evergreen (especially if
it turns out to be in volumes...). But thanks to Betty for doing that
cross-walk (which I just peeked at a minute ago) and we look forward to your
input!

-- 
-- 
| Karen G. Schneider
| Community Librarian
| Equinox Software Inc. "The Evergreen Experts"
| Toll-free: 1.877.Open.ILS (1.877.673.6457) x712
| E-Mail/AIM: kgs at esilibrary.com
| Web: http://www.esilibrary.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://list.georgialibraries.org/pipermail/open-ils-documentation/attachments/20090114/05dcce87/attachment.htm 


More information about the OPEN-ILS-DOCUMENTATION mailing list