evergreen-docs:reorg_2014:audience_focused_layout
This is an old revision of the document!
Table of Contents
Draft of Audience-Focused Layout
General Principles
- Separate content by audience
- Provide cross-linking where beneficial
- Provide global searching (and searching within current book?)
Separate Books Per Audience
Example: See Sitka's Evergreen Training Manual for staff-focused documentation.
BOOK: Developer / Consortium-level admin (server shell access)
QUESTION: Should these be two separate books?
- Evergreen Community (where to get help)
- Software Installation
- Migrating from a legacy system
- Migrating Patron Data
- System Configuration and Customization
- NEW SECTION: System Administration from the shell (how to restart clark, run helper scripts, etc.)
- See Support Scripts
- Creating a new skin
- TPAC Configuration and Customization
- Authentication Proxy
- SIP administration
- Apache administration (phonelist.pm, rewrite, access handler)
- NEW SECTION: Reports for Sys Admins
- NEW SECTION: Understanding Permissions (naming conventions, troubleshooting tips, working with permission groups)
- NEW SECTION: Optimizing your server
- Ask sys admins for more recommendations (e.g. for Apache, memcached, OS)
- Developer Resources
- Handy SQL queries (taken from random_magic_spells)
- The db schema
BOOK: Local admin (via staff client)
- Evergreen Community (where to get help)
- Installing the Staff Client
- System Administration From the Staff Client: overview
- Describing your organization
- Describing your people
- Library Settings Editor
- Acquisitions Administration
- Booking Administration
- Cataloging Administration
- Authorities Administration
- Z39.50 Administration
- Circulation Administration
- Borrowing items: who, what, for how long
- Hard due dates
- Accepting Credit Card Payments
- Stripe
- NEW SECTION: Paypal/Authorize.net/etc.
- Holds Administration
- OPAC Customization
- Reports Module
BOOK: Circulation Staff User
- Evergreen Community (where to get help)
- Using the Staff Client
- Circulation
- Reports (as relates to their needs)
- Using the Public Access Catalog (as relates to their workflows, and for helping patrons)
BOOK: Cataloging Staff User
- Evergreen Community (where to get help)
- Using the Staff Client
- Cataloging
- Reports (as relates to their needs)
- Using the Public Access Catalog (as relates to their workflows)
BOOK: Acquisitions Staff User
- Evergreen Community (where to get help)
- Using the Staff Client
- Acquisitions
- Reports (as relates to their needs)
- Using the Public Access Catalog (as relates to their workflows)
BOOK: Serials Staff User
- Evergreen Community (where to get help)
- Using the Staff Client
- Serials
- Reports (as relates to their needs)
- Using the Public Access Catalog (as relates to their workflows)
Concerns
- Where do details about permissions live? Stuff like this section is gold for troubleshooting permissions issues, but would it live in the cataloger's manual with other documentation of batch import? In the staff sysadmin's manual in a little tiny section of its own?
evergreen-docs/reorg_2014/audience_focused_layout.1455123940.txt.gz · Last modified: 2022/02/10 13:34 (external edit)