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

[Donald Butterworth]

Jillianne and Jane,

I like what you have done a *lot*. It makes so much sense and is less
intimidating for us cataloger types who shy away from system
administration.

I wonder ... could the concept be taken a step further to include hot
links, in Webby, to a constantly updated HTML version of the
documentation?  I see 3 possibilities.

   - Create a "Documentation" dropdown menu, consisting of all 7 docs,
   alongside of Search | Circulation | Cataloging | etc.
   - Add "Documentation" as a line item in the existing dropdown menus.
   - Ideally, right click on any dropdown menu line item, then have a line
   on the popup window with a context sensitive hot link. OCLC does something
   similar with a "MARC Field Help" hot link to its Bibliographic Formats and
   Standards.

Thanks so much for your great work! +1

Don



On Wed, Aug 23, 2017 at 4:37 PM, Mary Llewellyn <mllewell at biblio.org> wrote:

> I think it looks great, much less overwhelming to have the module
> documentation split up.
>
> Mary
>
>
> On Thu, Aug 17, 2017 at 3:28 PM, Ruth Frasur <director at hagerstownlibrary.
> org> wrote:
>
>> This looks great.  I appreciate the reasoning behind this schema and
>> think it's very usable.
>>
>> On Tue, Aug 15, 2017 at 2:43 PM, Jane Sandberg <sandbej at linnbenton.edu>
>> wrote:
>>
>>> 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
>>>
>>
>>
>>
>> --
>> Ruth Frasur
>> Director of the Historic(ally Awesome) Hagerstown - Jefferson Township
>> Library
>> 10 W. College Street in Hagerstown, Indiana (47346)
>> p (765) 489-5632; f (765) 489-5808
>>
>> *Our Kickin' Website <http://hagerstownlibrary.org>,  Our Rockin'
>> Facebook Page <http://facebook.com/hjtplibrary>,  and The Nettle Creek
>> Players <http://nettlecreekplayers.com>*
>>
>
>
>
> --
> Mary Llewellyn
> Database Manager
> Bibliomation, Inc.
> 24 Wooster Ave.
> Waterbury, CT 06708
> mllewell at biblio.org
>



-- 
Don Butterworth
Collection Management Librarian /
Faculty Associate
B.L. Fisher Library
Asbury Theological Seminary
don.butterworth at asburyseminary.edu
(859) 858-2227
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://libmail.georgialibraries.org/pipermail/open-ils-general/attachments/20170824/e3d8e390/attachment.html>