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 | k...@esilibrary.com | Web: http://www.esilibrary.com