[OPEN-ILS-GENERAL] Reorganized documentation: proof of concept

[Stroup, Meg]

Because I'm new to Evergreen, I've spent a lot of time trying to track down exactly what it is I'm looking for.  This revision makes it a lot easier to zero in on a specific subject.  Reorganizing the documentation by specific interest will be helpful for workgroups, as it makes it possible to link to a distinct chapter.  It's also a lot easier to skim, which makes it easier to see if you're really in the right place to answer a question.   Even searching by CTRL-F will be streamlined, because you're searching for a keyword in a specific part of the documentation.

These breakdowns make sense (to me) for our consortium, because they correspond fairly well with workgroups.

Thanks to everyone who worked on this!


Meg Stroup
SCLENDS Cataloging Coordinator
1500 Senate Street, Columbia, SC 29201
(803) 737-7736 | mstroup at statelibrary.sc.gov

Innovation | Collaboration | Participation


-----Original Message-----
From: Open-ils-general [mailto:open-ils-general-bounces at list.georgialibraries.org] On Behalf Of Jane Sandberg
Sent: Tuesday, August 15, 2017 2:43 PM
To: Evergreen Discussion Group <open-ils-general at list.georgialibraries.org>; Documentation discussion for Evergreen software <OPEN-ILS-DOCUMENTATION at list.georgialibraries.org>
Subject: [OPEN-ILS-GENERAL] Reorganized documentation: proof of concept

Dear Evergreeners,

Jillianne Presley and I have put together a proof of concept for a new direction for Evergreen's documentation, and DIG would really appreciate your input.

Rather than the current documentation, which tries to be many things to many people, the reorganized documentation is separated into separate manuals, each with its own audience (e.g. catalogers, front-line circ folks, sysadmins).  The hope is that this organization will help get the right content to the right people, and help DIG keep tabs on documentation gaps.

You can find the new manuals in the bottom half of this page:
http://docs-testing.evergreen-ils.org/

Keep in mind that -- in this proof-of-concept iteration -- there are some pieces of documentation that are in the wrong manual.  However, we hope that it is close enough that you'd be able to tell us:

a) if you think that reorganized documentation would be a valuable thing for this community to have.

b) if the current breakdowns of manuals would make sense for your library.

c) other feedback on this project.

Again, that link is http://docs-testing.evergreen-ils.org/

Thanks very much for your help,

   -Jane

--
Jane Sandberg
Electronic Resources Librarian
Linn-Benton Community College
sandbej at linnbenton.edu / 541-917-4655
Pronouns: she/her/hers or they/them/theirs