User Tools

Site Tools


Evergreen Documentation Needs

High level workflow for documenting new EG features

1. Choose a Task 2. Read Release Notes 3. Update the Docs

- Look at the task list below and add your name next to a task
- Need a wiki account? Just ask.

- Review the release notes entry for the feature (and/or the Launchpad bug)
- It may need a new section in one or more of the official manuals
- It may fit within an existing section
- It may only need updated screenshots
- You may be able to simply copy the release note into the appropriate section

- Make corrections in any
format (perhaps by editing
on GitHub) and share with the email list
- Learn more about ways to contribute your changes

Style Guide

3.12 Documentation Still Needed

List here all extant documentation needed for Evergreen version 3.12:

  • Hatch Print Config Angular Port (LP1965326) - there's not a lot on Hatch in general in the documentation.
  • Shelving Locations Editor: Hide deleted shelving locations by default (LP1917092) - can likely just be a quick/short addition maybe in the intro or in the section about deleting
  • Staff can now set a default item alert type for new item alerts (LP2017673)
  • Two new filter combo boxes have been added to the Holds Pull List (LP1968070) - (Done 5.31.24 - SM)
  • Grids throughout the staff client now have an option to print only rows that the user has selected, rather than printing all rows in the grid(LP2037128) - (Done 5.31.24 - SM)
  • Adds display of upcoming closures (as entered in the Closed Dates Editor) to the library information pages in the OPAC. (LP2017913)
  • Holdings Editor - call number attributes as part of holdings templates and change in template buttons (LP1983156) - also noting that existing section for the holdings editor is out of date

3.13 Documentation Still Needed

EASY Tasks for New Contributors

Bitesize (simple) documentation bugs on Launchpad:

Pull Requests ready for review

Add Index Terms Throughout the Docs

Add Terms and Definitions to the Glossary

Documentation Re-Organization Clean Up Tasks

Other Documentation Tasks


Check Sitka's documentation, especially when documenting older features: Also, consider adding links to their YouTube videos.

Quick Start Guides

We would like to provide an "Evergreen Quick Start" guide for the most common functions of Evergreen. The intended audience is library volunteers, student workers, and staff who are new to libraries. Learn more about the initial idea.

  • Some key features of such a guide would be:
    • Short (hopefully fitting on a single page printout)
    • Simple (no library jargon, no extra explanations)
    • Generic (not specific to any library or consortium)
    • Includes a short video
  • See Sitka's short videos for examples.

Here's a list of the guides we think we need. Feel free to add more!

Check In

Check Out

Adding Holdings

Adding call numbers and items to a bibliographic record.

  • How would you say "bibliographic record" without library jargon?

Undocumented Features/Changes, Taken From Release Notes

Many of these will be easy changes. Some will need no changes at all.

Copy the HTML code below to update the status of an item:

  • Assign yourself: <html><span style="color:blue;font-weight:bold">[your name]</span></html> ([your name])
  • Add a status: <html><span style="color: green;font-weight: bold"> COMPLETE!</span></html> (COMPLETE!)



Acquisitions Administration

Notification / Action Triggers

Circulation Administration

Credit Card Processing

Installation / Upgrade / Build / Translation

Integration with other software

Other (or not categorized yet)









* staff account password resets

Self Check Out

Other (or not categorized yet)


Public catalog



Borrow from Shared Docs

Other Requested Documentation

  • Cataloging (needs to be reorganized)
  • Intro to SQL (Based on Dan Scott content) Yamil still needs to make some edits like proper attribution, and test that its addition does not break the full docs
  • Library Settings Editor - (Lynn Floyd, SCLENDS)
  • OpenSRF/Evergreen Installation Guide (two PDFs linked from email below, useful but need updating)
  • Archiving of Circulation Transactions (new section)
  • Addresses on Routing List (missing?)
  • Wrong Cover Art, and what to do.

Non-Docs Tasks

  • Incorporate relevant docs links into Web Staff Client screens (i.e. contextual help)
  • Improve docs testing/building via the automated testing server (aka buildbot)
    • Currently, the docs are built (HTML, PDF and ePub) whenever the tests are run (every day around 6am and 6pm EST). If there is any warning or error output, it should signal a failure of the tests.
    • Ideas to improve this include:
  • Improve the PDF version of the built documentation (ask community for usage, ideas, etc.)
  • Setup/use Google analytics to improve docs website design
  • UI improvements
evergreen-docs/documentation_needs.txt · Last modified: 2024/06/12 12:17 by jpringle

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki

© 2008-2022 GPLS and others. Evergreen is open source software, freely licensed under GNU GPLv2 or later.
The Evergreen Project is a U.S. 501(c)3 non-profit organization.