Add content to about this documentation chapter.
authorRobert Soulliere <rsoulliere@libdog.mohawkcollege.ca>
Thu, 21 Oct 2010 19:19:04 +0000 (15:19 -0400)
committerRobert Soulliere <rsoulliere@libdog.mohawkcollege.ca>
Thu, 21 Oct 2010 19:19:04 +0000 (15:19 -0400)
1.6/appendices/about_this_documentation.xml

index 383f89d..102b3c2 100644 (file)
@@ -3,8 +3,203 @@
 xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:id="about_this_documentation">\r
        <info>\r
                <title>About this Documentation</title>\r
-               <abstract>\r
-                       <para></para>\r
-               </abstract>\r
        </info>\r
+       <section xml:id="aboutDIG">\r
+               <title>About the Documentation Interest Group (DIG)</title>\r
+               <para>The Evergreen DIG was established in May 2009 at the first Evergreen International Conference, where members of the Evergreen community committed to developing single-source, \r
+               standards-based documentation for Evergreen. Since then, the DIG has been actively working toward that goal.</para>\r
+               <table>\r
+                       <title>Evergreen DIG Participants</title>\r
+                       <tgroup align="left" cols="2" colsep="1" rowsep="1">\r
+                               <colspec colnum="1" colwidth="1.0*"/>\r
+                               <colspec colnum="2" colwidth="1.0*"/>\r
+                               <thead>\r
+                                       <row>\r
+                                               <entry>Name</entry>\r
+                                               <entry>Organization</entry>\r
+                                       </row>\r
+                               </thead>\r
+                               <tbody> \r
+                                       <row>\r
+                                               <entry>Jeremy Buhler</entry>\r
+                                               <entry>SITKA</entry>\r
+                                       </row>                                  \r
+                                       <row>\r
+                                               <entry>Paula Burton </entry>\r
+                                               <entry>King County Library System</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>Matt Carlson</entry>\r
+                                               <entry>King County Library System </entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>Sarah Childs</entry>\r
+                                               <entry>Hussey-Mayfield Memorial Public Library</entry>\r
+                                       </row>\r
+                                       \r
+                                       <row>\r
+                                               <entry>Anton Chuppin</entry>\r
+                                               <entry>Nova Scotia Provincial Library</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>Marlene Coleman</entry>\r
+                                               <entry>Beaufort Country Library</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>Karen Collier</entry>\r
+                                               <entry>Kent County Public Library </entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>Shannon Dineen</entry>\r
+                                               <entry>SITKA</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>George Duimovich</entry>\r
+                                               <entry>NRCan Library</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>Jennifer Durham</entry>\r
+                                               <entry>Statesboro Regional Library System</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>Jennifer Finney</entry>\r
+                                               <entry>Florence County Library</entry>\r
+                                       </row>  \r
+                                       <row>\r
+                                               <entry>Lynn Floyd</entry>\r
+                                               <entry>Anderson County Library</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>Tina Ji</entry>\r
+                                               <entry>SITKA</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>Catherine Lemmer</entry>\r
+                                               <entry>Indiana State Library</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>Roma Matott</entry>\r
+                                               <entry>Pioneer Library System</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>Andrea Neiman</entry>\r
+                                               <entry>Kent County Public Library</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>Kevin Pischke</entry>\r
+                                               <entry>William Jessup University </entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>Tara Robertson</entry>\r
+                                               <entry>N/A</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>Rod Schiffman</entry>\r
+                                               <entry>Alpha-G Consulting</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>Chris Sharp</entry>\r
+                                               <entry>Georgia Public Library Service</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>Steve Sheppard</entry>\r
+                                               <entry>Open</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>Ben Shum</entry>\r
+                                               <entry>Bibliomation</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>Robert Soulliere</entry>\r
+                                               <entry>Mohawk College</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>Lindsay Stratton</entry>\r
+                                               <entry>Pioneer Library System</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>Jenny Turner</entry>\r
+                                               <entry>PALS</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>Repke de Vries</entry>\r
+                                               <entry>International Institute for Social History</entry>\r
+                                       </row>\r
+                                       <row>\r
+                                               <entry>D. Ceabron Williams</entry>\r
+                                               <entry>Flint River Regional Library System </entry>\r
+                                       </row>\r
+                               \r
+                               </tbody>\r
+                       </tgroup>\r
+               </table>\r
+               <table>\r
+                       <title>Past DIG Participants</title>\r
+                       <tgroup align="left" cols="2" colsep="1" rowsep="1">\r
+                               <colspec colnum="1" colwidth="1.0*"/>\r
+                               <colspec colnum="2" colwidth="1.0*"/>\r
+                               <thead>\r
+                                       <row>\r
+                                               <entry>Name</entry>\r
+                                               <entry>Organization</entry>\r
+                                               \r
+                                       </row>\r
+                               </thead>\r
+                               <tbody> \r
+                                       <row>\r
+                                               <entry>Paul Weiss </entry>\r
+                                               <entry>Consultant/Sage Library System</entry>\r
+                                       </row>                                  \r
+                                       <row>\r
+                                               <entry>Karen Schneider</entry>\r
+                                               <entry>Equinox Software </entry>\r
+                                       </row>\r
+                               </tbody>\r
+                       </tgroup>\r
+               </table>        \r
+               <para>Special thanks goes to:</para>\r
+               <itemizedlist>\r
+                       <listitem>Jeremy Buhler and SITKA for providing DocBook style sheets, style guides and large portions of content for this documentation.</listitem>\r
+                       <listitem>Dan Scott from Laurentian University for providing large portions of content and many helpful tips.</listitem>\r
+                       <listitem>Mike Rylander, Grace Dunbar, Galen Charleton, Jason Etheridge, Bill Erickson, Joe Atzberger, Scott McKellar and all the other folks at Equinox Software for \r
+                       contributing large portions of content on the wiki.</listitem>\r
+               </itemizedlist>         \r
+               <para>There have been many other who have contributed there time to the Book of Evergreen project. Without their contributions to this community driven project, this documentation \r
+               would not be possible.</para>   \r
+       </section>\r
+       <section xml:id="howtoParticipate">\r
+               <title>How to Participate</title>\r
+               <para>Contributing to documentation is an excellent way to support Evergreen, even if you are new to documentation. In fact, beginners often have a distinct advantage over the \r
+               experts, more easily spotting the places where documentation is lacking or where it is unclear.</para>\r
+               <para>We welcome your contribution with planning, writing, editing, testing, translating to DocBook, and other tasks. Whatever your background or experience we are keen to \r
+               have your help!</para>  \r
+               <para>What you can do:</para>\r
+               <itemizedlist>\r
+                       <listitem>Join the Evergreen  documentation listserv: <link xl:href="http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation" \r
+                       xl:title="Join the DIG listserv">list.georgialibraries.org/mailman/listinfo/open-ils-documentation</link> . This is the primary way we communicate with each other. \r
+                       Please send an email introducing yourself to the list.</listitem>\r
+                       <listitem>Add yourself to the <link xl:href="http://evergreen-ils.org/dokuwiki/doku.php?id=evergreen-docs:digparticipants"> participant list</link> \r
+                       if you have an Evergreen DokuWiki account, or send a request to <email>docs@evergreen-ils.org</email>.</listitem>\r
+                       <listitem>Check out the <link xl:href="http://evergreen-ils.org/dokuwiki/doku.php?id=evergreen-docs:outline">documentation outline</link> to see which areas need work, \r
+                       and let the DIG list know in which areas you would like to work.</listitem>\r
+                       <listitem>Review the documentation and report any error or make suggestion using <link xl:href="https://bugs.launchpad.net/evergreen/+filebug">Launchpad</link>.</listitem>\r
+               </itemizedlist>\r
+               <simplesect>\r
+                       <title>Volunteer Roles</title>\r
+                       <para>We are now looking for people to help produce the documentation. If you interested in participating, email the DIG facilitators at <email>docs@evergreen-ils.org</email> \r
+                       or post on the documentation mailing list. We're looking for volunteers to work on the following:</para>\r
+                       <itemizedlist>\r
+                               <listitem>Writing – Produce the documentation (<quote>from scratch,</quote> and/or revised from existing materials). We're open to receiving content in any formats, such as \r
+                               Word or Open Office, but of course, would be most delighted with DocBook xml format.</listitem>\r
+                               <listitem>Testing – Compare the documents with the functions they describe and ensuring that the procedures accomplish the desired results. Even if you are not \r
+                               officially in the DIG, we would appreciate any suggestions you may have for Evergreen documentation.</listitem>\r
+                               <listitem>XML conversion – Convert existing documentation to DocBook format.</listitem>\r
+                               <listitem>Editorial review – Ensuring the documentation is clear and follows <link xl:href="http://docs.evergreen-ils.org/style_guide/html/">Evergreen DIG style \r
+                               guide</link> conventions.</listitem>\r
+                               <listitem>Style and Design – Edit the DocBook style sheets or post style tips and suggestions on the DIG list.</listitem>\r
+                       </itemizedlist>\r
+               </simplesect>\r
+       </section>              \r
 </appendix>\r
+\r
+\r