2.0/appendices/about_this_documentation.xml

   1 <?xml version='1.0' encoding='UTF-8'?>\r
   2 <appendix xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"\r
   3 xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:id="about_this_documentation">\r
   4         <info>\r
   5                 <title>About this Documentation</title>\r
   6         </info>\r
   7         <section xml:id="aboutDIG">\r
   8                 <title>About the Documentation Interest Group (DIG)</title>\r
   9                 <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
  10                 standards-based documentation for Evergreen. Since then, the DIG has been actively working toward that goal.</para>\r
  11                 <table>\r
  12                         <title>Evergreen DIG Participants</title>\r
  13                         <tgroup align="left" cols="2" colsep="1" rowsep="1">\r
  14                                 <colspec colnum="1" colwidth="1.0*"/>\r
  15                                 <colspec colnum="2" colwidth="1.0*"/>\r
  16                                 <thead>\r
  17                                         <row>\r
  18                                                 <entry>Name</entry>\r
  19                                                 <entry>Organization</entry>\r
  20                                         </row>\r
  21                                 </thead>\r
  22                                 <tbody> \r
  23                                         <row>\r
  24                                                 <entry>Jeremy Buhler</entry>\r
  25                                                 <entry>SITKA</entry>\r
  26                                         </row>                                  \r
  27                                         <row>\r
  28                                                 <entry>Paula Burton </entry>\r
  29                                                 <entry>King County Library System</entry>\r
  30                                         </row>\r
  31                                         <row>\r
  32                                                 <entry>Matt Carlson</entry>\r
  33                                                 <entry>King County Library System </entry>\r
  34                                         </row>\r
  35                                         <row>\r
  36                                                 <entry>Hilary Caws-Elwitt</entry>\r
  37                                                 <entry>Susquehanna County Library</entry>\r
  38                                         </row>\r
  39                                         <row>\r
  40                                                 <entry>Sarah Childs</entry>\r
  41                                                 <entry>Hussey-Mayfield Memorial Public Library</entry>\r
  42                                         </row>\r
  43                                         \r
  44                                         <row>\r
  45                                                 <entry>Anton Chuppin</entry>\r
  46                                                 <entry>Nova Scotia Provincial Library</entry>\r
  47                                         </row>\r
  48                                         <row>\r
  49                                                 <entry>Marlene Coleman</entry>\r
  50                                                 <entry>Beaufort Country Library</entry>\r
  51                                         </row>\r
  52                                         <row>\r
  53                                                 <entry>Karen Collier</entry>\r
  54                                                 <entry>Kent County Public Library </entry>\r
  55                                         </row>\r
  56                                         <row>\r
  57                                                 <entry>Shannon Dineen</entry>\r
  58                                                 <entry>SITKA</entry>\r
  59                                         </row>\r
  60                                         <row>\r
  61                                                 <entry>George Duimovich</entry>\r
  62                                                 <entry>NRCan Library</entry>\r
  63                                         </row>\r
  64                                         <row>\r
  65                                                 <entry>Jennifer Durham</entry>\r
  66                                                 <entry>Statesboro Regional Library System</entry>\r
  67                                         </row>\r
  68                                         <row>\r
  69                                                 <entry>Jennifer Finney</entry>\r
  70                                                 <entry>Florence County Library</entry>\r
  71                                         </row>  \r
  72                                         <row>\r
  73                                                 <entry>Lynn Floyd</entry>\r
  74                                                 <entry>Anderson County Library</entry>\r
  75                                         </row>\r
  76                                         <row>\r
  77                                                 <entry>Sally Fortin</entry>\r
  78                                                 <entry>Equinox Software</entry>\r
  79                                         </row>  \r
  80                                         <row>\r
  81                                                 <entry>Tina Ji</entry>\r
  82                                                 <entry>SITKA</entry>\r
  83                                         </row>\r
  84                                         <row>\r
  85                                                 <entry>Catherine Lemmer</entry>\r
  86                                                 <entry>Indiana State Library</entry>\r
  87                                         </row>\r
  88                                         <row>\r
  89                                                 <entry>Roma Matott</entry>\r
  90                                                 <entry>Pioneer Library System</entry>\r
  91                                         </row>\r
  92                                         <row>\r
  93                                                 <entry>Andrea Neiman</entry>\r
  94                                                 <entry>Kent County Public Library</entry>\r
  95                                         </row>\r
  96                                         <row>\r
  97                                                 <entry>Kevin Pischke</entry>\r
  98                                                 <entry>William Jessup University </entry>\r
  99                                         </row>\r
 100                                         <row>\r
 101                                                 <entry>Tara Robertson</entry>\r
 102                                                 <entry>N/A</entry>\r
 103                                         </row>\r
 104                                         <row>\r
 105                                                 <entry>Rod Schiffman</entry>\r
 106                                                 <entry>Alpha-G Consulting</entry>\r
 107                                         </row>\r
 108                                         <row>\r
 109                                                 <entry>Steve Sheppard</entry>\r
 110                                                 <entry>Open</entry>\r
 111                                         </row>\r
 112                                         <row>\r
 113                                                 <entry>Ben Shum</entry>\r
 114                                                 <entry>Bibliomation</entry>\r
 115                                         </row>\r
 116                                         <row>\r
 117                                                 <entry>Robert Soulliere</entry>\r
 118                                                 <entry>Mohawk College</entry>\r
 119                                         </row>\r
 120                                         <row>\r
 121                                                 <entry>Lindsay Stratton</entry>\r
 122                                                 <entry>Pioneer Library System</entry>\r
 123                                         </row>\r
 124                                         <row>\r
 125                                                 <entry>Yamil Suarez</entry>\r
 126                                                 <entry>Berklee College of Music</entry>\r
 127                                         </row>\r
 128                                         <row>\r
 129                                                 <entry>Jenny Turner</entry>\r
 130                                                 <entry>PALS</entry>\r
 131                                         </row>\r
 132                                         <row>\r
 133                                                 <entry>Repke de Vries</entry>\r
 134                                                 <entry>International Institute for Social History</entry>\r
 135                                         </row>\r
 136                                         <row>\r
 137                                                 <entry>D. Ceabron Williams</entry>\r
 138                                                 <entry>Flint River Regional Library System </entry>\r
 139                                         </row>\r
 140                                         <row>\r
 141                                                 <entry>Tigran Zargaryan</entry>\r
 142                                                 <entry>Fundamental Scientific Library of the National Academy of Sciences</entry>\r
 143                                         </row>\r
 144                                 </tbody>\r
 145                         </tgroup>\r
 146                 </table>\r
 147                 <table>\r
 148                         <title>Past DIG Participants</title>\r
 149                         <tgroup align="left" cols="2" colsep="1" rowsep="1">\r
 150                                 <colspec colnum="1" colwidth="1.0*"/>\r
 151                                 <colspec colnum="2" colwidth="1.0*"/>\r
 152                                 <thead>\r
 153                                         <row>\r
 154                                                 <entry>Name</entry>\r
 155                                                 <entry>Organization</entry>\r
 156                                                 \r
 157                                         </row>\r
 158                                 </thead>\r
 159                                 <tbody> \r
 160                                         <row>\r
 161                                                 <entry>Paul Weiss </entry>\r
 162                                                 <entry>Consultant/Sage Library System</entry>\r
 163                                         </row>                                  \r
 164                                         <row>\r
 165                                                 <entry>Karen Schneider</entry>\r
 166                                                 <entry>Equinox Software </entry>\r
 167                                         </row>\r
 168                                 </tbody>\r
 169                         </tgroup>\r
 170                 </table>        \r
 171         </section>\r
 172         <section xml:id="attributions">\r
 173                 <title>Attributions</title>             \r
 174                 <para>Copyright &#169; 2009-2011 <link linkend="aboutDIG">Evergreen  DIG</link></para>  \r
 175                 <para>Copyright &#169; 2007-2011 <link xl:href="http://www.esilibrary.com/esi/">Equinox</link></para>   \r
 176                 <para>Copyright &#169; 2007-2011 <link xl:href="http://coffeecode.net/">Dan Scott</link></para>\r
 177                 <para>Copyright &#169; 2009-2011 <link xl:href="http://sitka.bclibraries.ca/">BC Libraries Cooperative (SITKA)</link></para>\r
 178                 <para>Copyright &#169; 2008-2011 <link xl:href="http://www.kcls.org/">King County Library System</link></para>\r
 179                 <para>Copyright &#169; 2009-2010 <link xl:href="http://www.pls-net.org/">Pioneer Library System</link></para>\r
 180                 <para>Copyright &#169; 2009-2010 <link xl:href="http://www.mnpals.org/">PALS</link></para>\r
 181                 <para>Copyright &#169; 2009-2010 <link xl:href="http://www.georgialibraries.org/">Georgia Public Library Service</link></para>\r
 182                 <para>Copyright &#169; 2008-2010 <link xl:href="http://projectconifer.ca/">Project Conifer</link></para>\r
 183                 <para>Copyright &#169; 2009-2010 <link xl:href="http://biblio.org/">Bibliomation</link></para>\r
 184                 <para>Copyright &#169; 2008-2010 <link xl:href="http://www.in.gov/library/evergreen.htm">Evergreen Indiana</link></para>\r
 185         </section>\r
 186         <section xml:id="howtoParticipate">\r
 187                 <title>How to Participate</title><indexterm><primary>Documentation Interest Group (DIG)</primary></indexterm>\r
 188                 <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
 189                 experts, more easily spotting the places where documentation is lacking or where it is unclear.</para>\r
 190                 <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
 191                 have your help!</para>  \r
 192                 <para>What you can do:</para>\r
 193                 <itemizedlist>\r
 194                         <listitem>Join the Evergreen  documentation listserv: <link xl:href="http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation" \r
 195                         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
 196                         Please send an email introducing yourself to the list.</listitem><indexterm><primary>mailing lists</primary></indexterm>\r
 197                         <listitem>Add yourself to the <link xl:href="http://evergreen-ils.org/dokuwiki/doku.php?id=evergreen-docs:digparticipants"> participant list</link> \r
 198                         if you have an Evergreen DokuWiki account, or send a request to <email>docs@evergreen-ils.org</email>.</listitem>\r
 199                         <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
 200                         and let the DIG list know in which areas you would like to work.</listitem>\r
 201                         <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
 202                 </itemizedlist>\r
 203                 <simplesect>\r
 204                         <title>Volunteer Roles</title>\r
 205                         <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
 206                         or post on the documentation mailing list. We're looking for volunteers to work on the following:</para>\r
 207                         <itemizedlist>\r
 208                                 <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
 209                                 Word or Open Office, but of course, would be most delighted with DocBook xml format.</listitem>\r
 210                                 <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
 211                                 officially in the DIG, we would appreciate any suggestions you may have for Evergreen documentation.</listitem>\r
 212                                 <listitem>XML conversion – Convert existing documentation to DocBook format.</listitem>\r
 213                                 <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
 214                                 guide</link> conventions.</listitem>\r
 215                                 <listitem>Style and Design – Edit the DocBook style sheets or post style tips and suggestions on the DIG list.</listitem><indexterm><primary>DocBook</primary></indexterm>\r
 216                         </itemizedlist>\r
 217                 </simplesect>\r
 218         </section>              \r
 219 </appendix>\r
 220 \r
 221 \r