====== 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 [[http://docs.sitka.bclibraries.ca/Sitka/current/html/|Sitka's Evergreen Training Manual]] for staff-focused documentation. ==== BOOK: Developer / Consortium-level admin (server shell access) ==== QUESTION: Should these be two separate books? - See [[:eg_developer_overview|Evergreen Developer Overview]] - 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 [[http://docs.evergreen-ils.org/dev/_support_scripts.html|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 - See [[http://docs.evergreen-ils.org/dev/_adding_data_sources_to_reporter.html|Adding Data Sources to Reporter]] - NEW SECTION: Understanding Permissions (naming conventions, troubleshooting tips, working with permission groups) - See [[http://docs.evergreen-ils.org/dev/_describing_your_people.html|Describing your people]] - See [[http://docs.evergreen-ils.org/dev/_user_and_group_permissions.html|User and Group Permissions]] - NEW SECTION: Optimizing your server - See [[documentation:performance|Optimizing the performance of your Evergreen server]] - Ask sys admins for more recommendations (e.g. for Apache, memcached, OS) - Developer Resources - Handy SQL queries (taken from [[scratchpad:random_magic_spells]]) - The [[http://docs.evergreen-ils.org/2.8/schema/|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 [[http://docs.evergreen-ils.org/2.6/_batch_importing_marc_records.html#_permissions|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?