Book of Evergreen 1.6: Outline and Assignments

Below is a working outline for organizing the Documentation Interest Group's Book of Evergreen into Parts, Chapters, Sections, and Sections within Sections as deeply as needed. If you wish to make changes to the outline at the Part or Chapter level or that affect an area others are working on, please discuss your proposed changes on the documentation mailing list first. At the section and subsection level, many chapters are only vaguely organized. Your input on how to divide up these chapters into sections is greatly appreciated whether you edit the outline here or propose changes on the mailing list.

Besides helping keep the work in progress logically organized, this outline will also serve to keep track of who's working on which sections and subsections of the documentation at any given time and what stage those sections are in, so we can see which areas need volunteers and who to contact about a given section. When you undertake to write, test, edit, or convert a section to docbook, please add your name next to that section, and ideally your email address so others can contact you with questions, suggestions, and offers to help. Completed contributions should be submitted to the documentation mailing list for testing, editing, Docbook conversion, and committing to the repository.

Part: Introduction to Evergreen 1.6

Introduction and Intended Audience <HTML>DONE</HTML>
Chapter: About Evergreen (what it is, history, etc) <HTML>DONE</HTML>
Chapter: Key Concepts (organizational units and locations, flexible permissions by profile group home library or individual login, bib records/volumes/copies, item types/circ modifiers/item status/item stat cat, borrower groups/user stat cats, family accounts, patron notification/action triggers, buckets, holds behavior – targeting/retargeting/priority in filling/pull lists/expired holds/suspending holds/ holds across item types) - Ben Shum working on content <HTML>ASSIGNED</HTML>
Chapter: Release Notes <HTML>done up to 1.6.0.8, waiting for 1.6.1 release notes. - from: <a href="http://evergreen-ils.org/dokuwiki/doku.php?id=feature_list_1_6_0">http://evergreen-ils.org/dokuwiki/doku.php?id=feature_list_1_6_0</a></HTML>

Part: The Public Access Catalog

Introduction and Intended Audience <HTML>DONE</HTML>
Chapter: Basic Search - from SITKA DocBook <HTML>DONE</HTML>
- Section: Entering Search Terms (automatic and, Boolean has no meaning, minus for not, auto-stemming, generally fewer terms = more results, quotes for phrases, etc)
- Section: Basic Search Options (Limit fields to search, Limit formats to return, select locations to search, choose display language)
Chapter: Advanced Search - from SITKA DocBook <HTML>DONE</HTML>
- Section: Search Input
- Section: Sort Criteria
- Section: Search Library
- Section: Group Formats and Editions
- Section: Limit to Available
- Section: Search Filters
- Section: Quick Search
- Section: MARC Expert Search
- Section: Text Size and Language Options
Chapter: Search Tips - from SITKA DocBook <HTML>DONE</HTML>
Chapter: Search Methodology - from SITKA DocBook <HTML>DONE</HTML>
Chapter: Search URL - from http://www.open-ils.org/dokuwiki/doku.php?id=opac:dynamic_api <HTML>DONE</HTML>
Chapter: Search Results and Details Pages - from SITKA DocBook <HTML>DONE</HTML>
Chapter: My Account <HTML>Done</HTML>
- Section: Logging In (including required password change on first login, as well as self selected username alternative to card number)
- Section: Password Reset - Robert Soulliere <HTML>DONE</HTML>
- Section: Account Summary
- Section: Items Checked Out
- Section: Items on Hold
- Section: Fines
- Section: Account Preferences
- Section: My Bookbags
Chapter: Self Check (simple self check interface and not to be confused with complex SIP server and hardware setup. SIP server configuration is in the SIP server chapter.) <HTML>DONE</HTML>

Part: Core Staff Tasks

Introduction and Intended Audience <HTML>DONE</HTML>
Chapter: Using the Staff Client (Install, login, start page (varies by institution or consortium), managing tabs/windows/button bar, menus, keyboard shortcuts, column editor, workstation configuration, receipt templates, operator change, exiting) [work in-progress Lindsay Stratton (Pioneer) lstratton {at} pls-net.org] <HTML>DONE</HTML>
Chapter: Circulation [work in-progress Lindsay Stratton (Pioneer) lstratton {at} pls-net.org] <HTML>DONE</HTML>
Chapter: Cataloging - (Possibly divide the whole thing into two major sections on managing & adding holdings and managing & adding records?) [work in-progress Lindsay Stratton (Pioneer) lstratton {at} pls-net.org] <HTML>DONE</HTML>
- Section: Locating Records
- Section: Understanding the Holdings Maintenance Screen
- Section: Adding Holdings
 - Section: Adding Volumes
 - Section: Adding Items / Copies
 - Section: Adding Holdings for Multiple Volumes or Branches Simultaneously
- Section: Using the Copy Editor
 - Section: Using the Copy Editor to Make Changes
 - Section: Adding and Deleting Copy Notes
 - Section: Viewing Copy Notes in the OPAC (or maybe link this to the relevant section of the OPAC part?)
- Section: Item Templates (under Copy Editor?)
 - Section: Creating Templates
 - Section: Applying Templates
 - Section: Deleting Templates
 - Section: Changing Existing Templates
 - Section: Renaming Existing Templates
 - Section: Importing and Exporting Templates
- Section: Changing Call Numbers
- Section: Replacing Barcodes
- Section: Transferring Volumes and Items
 - Section: Transferring Volumes from One Record or Branch to Another
 - Section: Transferring Items from One Volume to Another
- Section: Printing Spine and Pocket Labels
 - Section: Printing Labels for New Items
 - Section: Printing Labels for Existing Items
 - Section: Pocket Labels
- Section: Using the MARC Editor
 - Section: Editing Fixed Fields
 - Section: Editing the MARC Record
 - Section: Validating Records
- Section: Adding New Records via Built In Z39.50 Client
 - Section: Z39.50 Screen Features
 - Section: Importing a record via Z39.50
 - Section: Record Collisions
 - Section: Fast Item Adds
 - Section: Raw Searches
- Section: Overlaying Records (Under Z 39.50?)
 - Section: Marking Records for Overlay
- Section: Batch Importer / Exporter
 - Section: Importing Bibliographic Records
 - Section: Importing Authority Records
 - Section: Using the Import Queue
 - Section: Exports
 - Section: Editing Record Attributes on Import
- Section: Creating Original Records in Evergreen
- Section: Deleting Records from Holdings Maintenance
 - Section: Deleting Item Records from Evergreen
 - Section: Deleting Volume Records from Evergreen
 - Section: Deleting Bibliographic Records from Evergreen
 - Section: Undeleting Records
- Section: The Item Status Screen (This is geared for use by catalogers - should there be separate sections on Item Status for different users, or should there be one multi-purpose guide with links for different areas. Same question with searching, using tabs, holds?)
 - Section: Checking Your Work Using the Item Status Screen
 - Section: Using the Item Status Screen to Make Changes to Multiple Items
 - Section: Saving Report Data in Excel for Use with the Item Status Screen
 - Section: Using Notepad to Save Report Data as a Text File
 - Section: Importing Data to the Item Status Screen from a Text File
- Section: Pre-Cats
 - Section: Deleting Pre-Cat Items
 - Section: Transferring Pre-Cat Items to Bibliographic Records
- Section: Copy Buckets
 - Section: Creating New Copy Buckets from the Bucket Manager
 - Section: Viewing Copy Buckets
 - Section: Adding Items to Copy Buckets from Holdings Maintenance or Item Status
 - Section: Creating New Buckets when Adding Items to Buckets
 - Section: Adding Items to Copy Buckets from the Bucket Manager
 - Section: Copying Copy Buckets
 - Section: Using Copy Bucket Manager Batch Function Tools
 - Section: Sharing Copy Buckets
 - Section: Removing Contents from Copy Buckets
 - Section: Deleting Copy Buckets
- Section: Record Buckets
 - Creating New Record Buckets from the Bucket Manager
 - Viewing Record Buckets
 - Adding Records to Buckets when Viewing Records in the Catalog
 - Creating New Record Buckets when Adding Records to Buckets
 - Adding Records to Buckets from the Bucket Manager
 - Copying Record Buckets
 - Merging Records
 - Additional Record Bucket Manager Batch Function Tools
 - Sharing Record Buckets
 - Removing Contents from Record Buckets
 - Deleting Record Buckets
Chapter: Booking - content from Equinox <HTML>DONE</HTML>
Chapter: Acquisitions <HTML>Leave out of 1.6 since it is not functional until 2.0?</HTML>
(In future: Serials and Course Reserves Chapters too)

Part: Administration

Introduction and Intended Audience (mention any wiki pages that should be seen also for up to the minute info, as well as any general resources on server administration someone lacking experience might want to consult) - Robert Soulliere <HTML>DONE</HTML>
Chapter: System Requirements and Recommended Configuration(s) - Robert Soulliere <HTML>DONE</HTML>
Chapter: Evergreen Installation
- Section: Server-side Installation - Steve Sheppard <HTML>DONE</HTML>
- Section: Installing Evergreen 1.6.1.x On Ubuntu and Debian <HTML>DONE - from: <a href="http://evergreen-ils.org/dokuwiki/doku.php?id=server:1.6.1:install&s[]=1&s[]=6&s[]=0&s[]=7">http://evergreen-ils.org/dokuwiki/doku.php?id=server:1.6.1:install&s[]=1&s[]=6&s[]=0&s[]=7</a></HTML>
- Section: Installing OpenSRF 1.4.x On Ubuntu and Debian <HTML>DONE - from: <a href="http://www.open-ils.org/dokuwiki/doku.php?id=opensrf:1.4:install">http://evergreen-ils.org/dokuwiki/doku.php?id=opensrf:1.4:install</a></HTML>
- Section: Installing in Virtualized Unix Environments <HTML>DONE</HTML>
Chapter: Staff Client Installation - Steve Sheppard <HTML>DONE - from: <a href="http://evergreen-ils.org/dokuwiki/doku.php?id=evergreen-user:installing_and_running_the_staff_client">http://evergreen-ils.org/dokuwiki/doku.php?id=evergreen-user:installing_and_running_the_staff_client</a>

</HTML>

Chapter: Upgrading to Version 1.6 from Version 1.4 - Robert Soulliere <HTML>DONE - from: <a href="http://www.open-ils.org/dokuwiki/doku.php?id=upgrading:evergreen:1.4_to_1.6">http://www.open-ils.org/dokuwiki/doku.php?id=upgrading:evergreen:1.4_to_1.6</a></HTML>
Chapter: Starting, Stopping, Backups, Security, and Maintenance (other miscellanea?) - Robert Soulliere <HTML>Done - add and improve as needed</HTML>
- Section: Starting, Stopping and Restarting OpenSRF/Evergreen
- Section: Backing Up (Evergreen database and files)
- Section: Security
- Section: Managing Log Files
- Section: Installing PostgreSQL from Source <HTML>DONE - from: <a href="http://evergreen-ils.org/dokuwiki/doku.php?id=postgresql:8.2:debian&s[]=postgresql">http://evergreen-ils.org/dokuwiki/doku.php?id=postgresql:8.2:debian&s[]=postgresql</a></HTML>
- Section: Configuring PostgreSQL <HTML>DONE - from: <a href="http://evergreen-ils.org/dokuwiki/doku.php?id=postgresql:8.2:debian&s[]=postgresql">http://evergreen-ils.org/dokuwiki/doku.php?id=postgresql:8.2:debian&s[]=postgresql</a></HTML>
- Section: Cron Jobs - Ben Shum <HTML>ASSIGNED </HTML>
Chapter: Server Administration (System-wide customization options) - Robert Soulliere & Roma Matott
- Section: Organizational Unit Types and Organizational Units <HTML>DONE</HTML>
- Section: User and Group Permissions <HTML>DONE</HTML>
- Section: Copy Status <HTML>DONE</HTML>
- Section: MARC Codes <HTML>NEEDED</HTML>
- Section: Billing Types <HTML>DONE</HTML>
- Section: Z39.50 Servers <HTML>NEEDED</HTML>
- Section: Circulation Modifiers <HTML>DONE</HTML>
- Section: Booking Module - Jeremy Buhler <HTML>DONE</HTML> - adapted from http://evergreen-ils.org/dokuwiki/doku.php?id=booking
- Section: Email Notifications <HTML>DONE</HTML>
- Section: Cataloging Templates <HTML>DONE</HTML>
- Section: Adjusting Search Relevancy Rankings <HTML>DONE</HTML>
Chapter: Local Administration (Local customizatioon options & tools for admin staff at all org-unit levels, excluding reporting which gets its own chapter)
- Section:Receipt Template Editor <HTML>DONE</HTML>
- Section:Global Font and Sound Settings <HTML>DONE</HTML>
- Section:Printer Settings Editor <HTML>DONE</HTML>
- Section:Closed Dates Editor <HTML>DONE</HTML>
- Section:Copy Locations Editor <HTML>DONE</HTML>
- Section:Library Settings Editor <HTML>DONE</HTML>
- Section:Non-Catalogued Type Editor <HTML>DONE</HTML>
- Section:Statistical Categories Editor <HTML>DONE</HTML>
- Section: Standing Penalties <HTML>NEEDED</HTML>
- Section: Group Penalty Thresholds <HTML>DONE</HTML>
- Section: Field Documentation – Contributed by James Fournie <HTML>DONE</HTML>
- Section: Notifications/Action Triggers <HTML>NEEDED</HTML>
- Section:Surveys <HTML>DONE</HTML>
- Section: Reports <HTML>DONE</HTML> - needs expanding: SQL reports, source information
- Section:Cash Reports <HTML>DONE</HTML>
- Section: Transit List <HTML>NEEDED</HTML>
- Section: Circulation Policies <HTML>NEEDED</HTML>
- Section: Hold Policies <HTML>NEEDED</HTML>
Chapter: Migrating Data (general principles, perhaps supplemented with specific examples when possible?) - Robert Soulliere, contribution by Repke de Vries, IISH <HTML>NEEDS review and examples.</HTML>
Chapter: Z39.50 Server - Robert Soulliere <HTML>DONE - from: <a href="http://www.open-ils.org/dokuwiki/doku.php?id=evergreen-admin:sru_and_z39.50&s[]=z3950">http://www.open-ils.org/dokuwiki/doku.php?id=evergreen-admin:sru_and_z39.50&s[]=z3950</a></HTML>
Chapter: SIP2 - Robert Soulliere <HTML>DONE - from: <a href="http://evergreen-ils.org/dokuwiki/doku.php?id=evergreen-admin:sip&s[]=sip">http://evergreen-ils.org/dokuwiki/doku.php?id=evergreen-admin:sip&s[]=sip</a> and <a href="http://evergreen-ils.org/dokuwiki/doku.php?id=evergreen-admin:sip_support&s[]=sip">http://evergreen-ils.org/dokuwiki/doku.php?id=evergreen-admin:sip_support&s[]=sip</a></HTML>
Chapter: Localization and Languages - Contribution by Tigran Zargaryan <HTML>ASSIGNED</HTML>
Chapter: Troubleshooting - Robert Soulliere <HTML>DONE - from: <a href="http://evergreen-ils.org/dokuwiki/doku.php?id=troubleshooting:checking_for_errors&s[]=troubleshooting">http://evergreen-ils.org/dokuwiki/doku.php?id=troubleshooting:checking_for_errors&s[]=troubleshooting</a></HTML>
Chapter: Action Triggers - Robert Soulliere <HTML>DONE</HTML>
Chapter: Booking Module Administration - Jeremy Buhler <HTML>DONE</HTML>

Part: Reports

Chapter: Starting and Stopping the Reporter Daemon <HTML>DONE</HTML>
Chapter: Folders (Robert Soulliere from SITKA DocBook) <HTML>DONE</HTML>
Chapter: Creating Templates (Robert Soulliere from SITKA DocBook) <HTML>DONE</HTML>
Chapter: Generating Reports from Templates (Robert Soulliere from SITKA DocBook) <HTML>DONE</HTML>
Chapter: Viewing Report Output (Robert Soulliere from SITKA DocBook) <HTML>DONE</HTML>
Chapter: Cloning Shared Templates (Robert Soulliere from SITKA DocBook) <HTML>DONE</HTML>
Chapter: Running Recurring Reports (Robert Soulliere from SITKA DocBook) <HTML>DONE</HTML>
Chapter: Template Terminology (Robert Soulliere from SITKA DocBook) <HTML>DONE</HTML>
Chapter: SQL Reports <HTML>NEEDED</HTML>

Part: Third Party System Integration

Introduction and Intended Audience
Chapter: Integrating Evergreen Data in Third Party Applications <HTML>NEEDED</HTML>
- Section: OpenSRF (potential overlap with Developement -> API -> OpenSRF)
- Section: SuperCat
- Section: SRU (Z39.50 [EG as target] deliberately left out)
- Section: OpenSearch
- Section: unAPI
- Section: SIP2
- Section: Feeds
- Section: Asteriks and other Telephony Systems
- Section: EDI

Part: Development

Introduction and Intended Audience <HTML>DONE</HTML>
Chapter: OpenSRF Introduction (from Dan Scott's Article; Robert Soulliere will convert to docbook) - <HTML>DONE</HTML>
Chapter: Developing OpenSRF and Evergreen Applications (from Dan Scott's Workshop; Robert Soulliere will convert to docbook;) - <HTML>DONE</HTML>
Chapter: Intro to SQL (from Dan Scott's tutorial; Robert Soulliere will convert to docbook.) <HTML>DONE</HTML>
Chapter: JSON - Robert Soulliere will convert content from wiki <HTML>DONE - from: <a href="http://evergreen-ils.org/dokuwiki/doku.php?id=documentation:technical:jsontutorial&s[]=json">http://evergreen-ils.org/dokuwiki/doku.php?id=documentation:technical:jsontutorial&s[]=json</a></HTML>
Chapter: File Structure and Configuration Files <HTML>DONE</HTML>
Chapter: Customizing the Staff Client (theme, labels & messages) <HTML>DONE</HTML>
Chapter: Customizing the OPAC - Robert Soullere
- Section: Color Schemes <HTML>DONE - based on: <a href="http://evergreen-ils.org/dokuwiki/doku.php?id=evergreen-admin:customizations:opac&s[]=color&s[]=scheme">http://evergreen-ils.org/dokuwiki/doku.php?id=evergreen-admin:customizations:opac&s[]=color&s[]=scheme</a></HTML>
- Section: Text and Labels <HTML>DONE - based on: <a href="http://evergreen-ils.org/dokuwiki/doku.php?id=evergreen-admin:customizations:opac&s[]=color&s[]=scheme">http://evergreen-ils.org/dokuwiki/doku.php?id=evergreen-admin:customizations:opac&s[]=color&s[]=scheme</a></HTML>
- Section: Logo Images <HTML>DONE - based on: <a href="http://evergreen-ils.org/dokuwiki/doku.php?id=evergreen-admin:customizations:opac&s[]=color&s[]=scheme">http://evergreen-ils.org/dokuwiki/doku.php?id=evergreen-admin:customizations:opac&s[]=color&s[]=scheme</a></HTML>
- Section: Added Content <HTML>DONE</HTML>
- Section: Customizing the Results Page <HTML>DONE</HTML>
- Section: Customizing the Details Page <HTML>DONE</HTML>
- Section: BibTemplate <HTML>DONE - partly based on: <a href="http://evergreen-ils.org/dokuwiki/doku.php?id=opac:bibtemplate&s[]=bibtemplate">http://evergreen-ils.org/dokuwiki/doku.php?id=opac:bibtemplate&s[]=bibtemplate</a> and from Dan Scott's presentation at the Evergreen International Conference, 2010</HTML>
- Section: Integrated Catalog Search Box <HTML>DONE</HTML>
- Section: Customizing the Slimpac <HTML>DONE</HTML>
Chapter: SuperCat Web Services
- Section: Searching with SuperCat - Robert Soulliere <HTML>DONE- from: <a href="http://evergreen-ils.org/dokuwiki/doku.php?id=backend-devel:supercat:examples&s[]=supercat">http://evergreen-ils.org/dokuwiki/doku.php?id=backend-devel:supercat:examples&s[]=supercat</a></HTML>
- Section: Customizing SuperCat Results - <HTML>done - very basic</HTML>
- Section: Adding Formats to SuperCat - <HTML>done - very basic</HTML>

Appendices

Glossary <HTML>Needs Work</HTML>
Index <HTML>generated by DocBook but editors need to indicate which terms will be indexed.</HTML> See http://www.docbook.org/tdg5/en/html/indexterm.singular.html
Installation and Configuration Checklist (quick checklist of tasks to install and configure Evergreen) <HTML>DONE</HTML>
Database Schemas (Robert Soulliere) - <HTML>auto-generated using autodoc</HTML>
About This Documentation and DIG (Call for participation & credit for participants) <HTML>DONE</HTML>
More Information (point to open-ils.org, mailing lists, etc) <HTML>DONE</HTML>

evergreen-docs/outline.txt · Last modified: 2022/02/10 13:34 by 127.0.0.1

Evergreen DokuWiki

Table of Contents