2020 - 2021 Documentation Working Group Updates

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:

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.