2020 - 2021 Documentation Working Group Updates
This page archives documentation updates from Marcia Borensztayn as part of standing up docs.folio.org as a documentation site.
-----------------------
January 7, 2021
Phase 2 is complete. Advances include:
- Enabled access to the live site from folio.org
- Established presence in JIRA for documentation
- Refined drafts of Resource Access content
- Created draft of content for the new Circulation Log app
- Refined drafts of Installation content
Next steps:
- Enable access to docs.folio.org/docs from the UI
- Conduct final review of Resource Access content (Check in, Check out, Reserves, Courses, and Circulation Log)
- Conduct final review of Installation content
- Begin documentation of Orders, Finance, Invoices, and Receiving apps
- Create version control strategy for older versions of FOLIO documentation
- Work with POs and others to use JIRA for maintenance of published content
-----------------------
October 29, 2020
Highlights of recent advances include:
- Published initial site: see https://docs.folio.org
- Established documentation version control using GitHub: see https://github.com/folio-org/docs
- Selected Google Developer Style Guide: see https://developers.google.com/style
DRAFT content created:
- Google Season of Docs writer (José Ortiz): drafted content for Getting Started and Installation
- Google Season of Docs writer (Lauren Gallina): drafted content for Check in, Courses, Reserves
- Drafted content for Home, About, Features, Benefits, License
- Drafted content for Check out
Next steps:
- Lay groundwork for accessing the site from folio.org and the UI
- Create strategy for effective use of JIRA to track and manage documentation work
- Address additional technical issues
- Establish roles for documentation review
- Refine current content; review with subject matter experts
-----------------------
October 12, 2020
FOLIO documentation efforts are underway. See the Information Plan for details of each phase.
Phase 1 of the plan is complete. Highlights include:
- Creation of a demo documentation site
- Creation of high-level content structure (TOC)
- Creation of initial draft for Check out / Check in apps
- Onboarding of Google Season of Docs technical writers
In Phase 2, the first items to address are:
- Moving the demo site to an accessible location
- Establishing a docs repository on the FOLIO GitHub site
- Improving initial draft content
- Selecting the next areas to document
- Documenting some FOLIO installation options
Phase 2 will be complete in the mid-end November timeframe.