Well... in regards to suggested revisions by DIG the important factor to remember is that there is probably only a handful of Evergreen acquisitions experts in the entire world or those with enough experience to revise what has been created. I am not sure who if anyone currently actively involved in DIG would be able to provide expert level content revisions. That being said, If a group could be formed to review, test and perhaps merge the best of both documents that might be one approach. However, given the voluntary nature of DIG, it might take a while to review the content given that the acquisition document from GPLS is 45 pages alone. During the content review phase among a small group of acquisition specialists, if we decide to go this route and can round up these specialists, could review the documents in word / open office /basic text format until a final version can be merged into once version. (We could move the document into wiki format as suggested by some, but it seems like an awful lot of work to convert to that format for review of such a large document.) Once content is refined, it can be forwarded to the DocBook conversion team (me) to be converted to DocBook XML and added to the official documentation.
A second approach would be to convert and add both documents side by side "as is" into the official documentation to allow quicker publication and inclusion in the official Evergreen documentation. Then, the documentation could be reviewed by the larger community and refined gradually through feedback by the community and users of the documentation. It could then be eventually merged into one near perfect document through gradual evolution based on feedback from users. I would lean towards this approach and would expect the documentation "as is" to get into the official docs within several months. The other approach might take longer time to reach publication depending on the number of perfectionists on the content review team. The GPLS documentation looked pretty good and will help a lot of users and I am sure both documents have very useful and critical information for Evergreen users trying to get their heads around acquisitions. Regards, Robert Robert Soulliere, BA (Hons), MLIS Systems Librarian Mohawk College Library [email protected] Telephone: 905 575 1212 x3936 Fax: 905 575 2011 ________________________________________ From: [email protected] [[email protected]] On Behalf Of Lori Bowen Ayre [[email protected]] Sent: March 4, 2011 6:37 PM To: Evergreen Discussion Group Cc: Soulliere, Robert; [email protected] Subject: Re: [OPEN-ILS-GENERAL] Acquisitions and Serials Documentation Drafts Now Available Robert, I'm happy to give DIG the set of procedures I have from KCLS, and I guess you can snag the PINES/ESI *.docs from the wiki. Would it reasonable to have the DIG get back to everyone on this list with suggested revisions as well as recommendations for where this stuff all lives? Advise if I'm stepping out of line...just trying to keep this discussion moving forward toward some kind of resolution! Lori On Fri, Mar 4, 2011 at 8:12 AM, Soulliere, Robert <[email protected]<mailto:[email protected]>> wrote: I think having the discussion on the Documentation list is important as well. The hope is that the Acquisitions. documentation would be included as part of the official documentation for 2.0: http://docs.evergreen-ils.org/2.0/draft/html/ I think it would be best to get the documentation into DocBook XML format which could then be processed in both HTML and PDF as part of the official documentation. Would the DIG list be a good place to have the discussion and provide feedback on documentation? Robert Robert Soulliere, BA (Hons), MLIS Systems Librarian Mohawk College Library [email protected]<mailto:[email protected]> Telephone: 905 575 1212 x3936 Fax: 905 575 2011 ________________________________________ From: [email protected]<mailto:[email protected]> [[email protected]<mailto:[email protected]>] On Behalf Of Lori Bowen Ayre [[email protected]<mailto:[email protected]>] Sent: March 4, 2011 10:29 AM To: Evergreen Discussion Group Subject: Re: [OPEN-ILS-GENERAL] Acquisitions and Serials Documentation Drafts Now Available Mary, I'm happy to share them (on KCLS' behalf). Question: Would it be useful for me to post these on the wiki with the "official draft" of Acq documentation? I'm wondering if it would be useful to have a place to post info about procedures or potential workflows with the official documentation. I see these two types of documents very differently but both are equally important. And, is there a protocol in place for providing feedback on the draft documentation that is posted? Seems like publicly sharing our comments would be useful. I'm wondering if the documentation could be provided on a wiki and in wiki format instead of PDF? I'm thinking of the way Dan Scott put up the proposed rules of governance recently so we could all provide feedback. That would make all feedback visible and easier to keep track of for whomever gets to consolidate that feedback. Should we be having this discussion on the Documentation list too? Lori (speaking largely in her role as a Communications Committee member!) On Fri, Mar 4, 2011 at 7:07 AM, Mary Llewellyn <[email protected]<mailto:[email protected]><mailto:[email protected]<mailto:[email protected]>>> wrote: Yes, please!!!! At 10:02 AM 3/4/2011, Lori Bowen Ayre wrote: Hi All, I just got my hands on a copy of what is more like a procedures guides than "documentation" for ordering, receiving and invoicing. It is from KCLS. I don't want to introduce any confusion finalizing the documentation PINES/ESI has put together. But if anyone would like a copy of of the workflow KCLS is using, let me know. Lori On Thu, Mar 3, 2011 at 5:53 PM, McKinney, Elizabeth < [email protected]<mailto:[email protected]><mailto:[email protected]<mailto:[email protected]>>> wrote: Draft documentation for acquisitions and serials is now available at http://evergreen-ils.org/dokuwiki/doku.php?id=start See the links to the three PDF files in the Documentation section. Please note that these are drafts created by Equinox on behalf of the Georgia Public Library Service. We will have a 30 day review period before these documents are finalized and become resources of the Evergreen community. Please don't hesitate to give us your feedback. Elizabeth Elizabeth McKinney PINES Program Director Georgia Public Library Service A Unit of the University System of Georgia 1800 Century Place, Suite 150 Atlanta GA 30345 404.235.7141 [email protected]<mailto:[email protected]><mailto:[email protected]<mailto:[email protected]>> http://www.georgialibraries.org/ -- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-==-=-=-=-=-=-=-=-= Lori Bowen Ayre // Library Technology Consultant The Galecia Group // www.galecia.com<http://www.galecia.com><http://www.galecia.com/> (707) 763-6869 // [email protected]<mailto:[email protected]><mailto:[email protected]<mailto:[email protected]>> Specializing in open source ILS solutions, RFID, filtering, workflow optimization, and materials handling =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= Mary Llewellyn Mary Llewellyn Database Manager Bibliomation, Inc. Middlebury, CT [email protected]<mailto:[email protected]><mailto:[email protected]<mailto:[email protected]>> -- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-==-=-=-=-=-=-=-=-= Lori Bowen Ayre // Library Technology Consultant The Galecia Group // www.galecia.com<http://www.galecia.com><http://www.galecia.com/> (707) 763-6869 // [email protected]<mailto:[email protected]><mailto:[email protected]<mailto:[email protected]>> <mailto:[email protected]<mailto:[email protected]>>Specializing in open source ILS solutions, RFID, filtering, workflow optimization, and materials handling =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= This E-mail contains privileged and confidential information intended only for the individual or entity named in the message. If the reader of this message is not the intended recipient, or the agent responsible to deliver it to the intended recipient, you are hereby notified that any review, dissemination, distribution or copying of this communication is prohibited. If this communication was received in error, please notify the sender by reply E-mail immediately, and delete and destroy the original message. -- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-==-=-=-=-=-=-=-=-= Lori Bowen Ayre // Library Technology Consultant The Galecia Group // www.galecia.com<http://www.galecia.com/> (707) 763-6869 // [email protected]<mailto:[email protected]> <mailto:[email protected]>Specializing in open source ILS solutions, RFID, filtering, workflow optimization, and materials handling =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= This E-mail contains privileged and confidential information intended only for the individual or entity named in the message. If the reader of this message is not the intended recipient, or the agent responsible to deliver it to the intended recipient, you are hereby notified that any review, dissemination, distribution or copying of this communication is prohibited. If this communication was received in error, please notify the sender by reply E-mail immediately, and delete and destroy the original message. _______________________________________________ OPEN-ILS-DOCUMENTATION mailing list [email protected] http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation
