[OPEN-ILS-DEV] Evergreen Documentation Interest Group

[Karen Schneider]

Note: this summary is being posted to the three Evergreen discussion lists
(general, documentation, and development). Future discussions about the
Evergreen documentation project will take place on the Evergreen
documentation list (though news of note may be posted to other lists on
occasion). To subscribe to open-ils-documentation (or other Evergreen
lists), see http://evergreen-ils.org/listserv.php

On Wednesday, May 20, 2009, at the Evergreen International Conference, close
to two dozen members of the Evergreen community participated in a
documentation planning discussion.

Following a presentation about documentation (see notes below), the group
took the following actions and (unanimously) made the following commitments:


* Established an Evergreen documentation interest group, aka DIG, or even,
the DIGgers
* Agreed to meet regularly to plan and implement the Evergreen documentation
project
* Agreed that core Evergreen documentation should be based on one
single-source, standards-based, open format
* Agreed that DocBook was the format of choice for Evergreen documentation
* Agreed that community members could contribute documentation in any
format, and the DIG would convert to DocBook format as required
* Agreed that the initial organizing meetings should clarify roles and tasks
* Agreed that Karen Schneider and Paul Weiss would lead this project at this
point in time

There will be a meeting 3 p.m. Eastern Time Wednesday, June 10, to discuss
initial roles and tasks. Meeting details will be sent out separately, via
the Evergreen documentation list.

Some of the earliest activities for the DIG will include establishing a
timeline and a regular meeting schedule, and identifying initial tasks for
project participants and recruiting for each role. Some of the preliminary
groundwork for the project, once volunteers have committed to specific
areas, will include identifying a core DocBook subset of tags for Evergreen
documentation, writing an Evergreen style (markup) guide, developing
heavily-annotated model templates, and providing toolset advice.

Documentation News of Note

The evergreen-ils.org website has been updated so that the Documentation
list stands on its own, rather than being listed under Development. (See
http://evergreen-ils.org/listserv.php )

Slides from the May 20 discussion are on Slideshare:

http://www.slideshare.net/evergreenils/evergreen-docs-planning-session-2009(full
set)

http://www.slideshare.net/evergreenils/evergreen-documentation-lightning-talk(short
set)


-- 
-- 
| 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
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://libmail.georgialibraries.org/pipermail/open-ils-dev/attachments/20090603/aaa733aa/attachment.htm