Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Date

Attendees

(OLD ACCOUNT) Erin Nettifee

Donna Minor

Cornelia Awenius

Andrea Loigman

Martina Tumulla

Monica Arnold

Brooks Travis

Andy Horbal

Erin Weller

Laurence Mini

Karen White

Amelia Sutton

Martina Tumulla

Molly Driscoll

Mark Canney

David Bottorff

Joanne Leary

Rameka Barnes

Jana Freytag




Discussion Items

TimeItemWhoDescriptionGoals/Info
2minAdministrivia

presentations by implementing libraries





documentation


Erin - Continue working on in-app reports document
https://docs.google.com/spreadsheets/d/1Jr1FM9KNVdWZVkx2HcpuDgdBZENsQk5U/edit?usp=drive_web&ouid=101818288105864628077&dls=true


RA Documentation Review

Set steps for our documentation efforts - we talked about last week:

  • Documentation group spinning up soon
  • A lot of our basic functionality is already documented:
  • Update on Documentation Working Group

    What do we think is missing in this architecture?

    • cross-app workflow documentation?
    • more "behind the scenes" docs? e.g., things libraries should know about workarounds, tips for how to do things more efficiently, other?
    • docs for RA features that take place in Users?
    • docs for RA workflows in Inventory?

    Proceeding with our list

    • Which schools are writing documentation right now? Can we use those efforts to provide a baseline for community documentation?
    • What would people most effective? A sign-up process to help? Some other method?


    the implementation process



    ...

    Functional Area

    Product Owner

    Planned Release (if known)

    Decision Reached

    Reasoning

    Link to supporting materials

    Comments

    e.g. loans, fees/finesNamee.g. Q4 2018, Q1 2019Clearly stated decision
    • Because...
    • Because...
    e.g. mock-up, JIRA issue




























    Notes

    David Bottorff, note-taker

    • In-app reports document -

      • we've gone through almost all of them other than 3 inventory reports (instance UUIDs via csv file, two others nonfunctional exports to MARC or JSON)

      • circulation log results export to CSV but not developed yet (Iris)

      • will need to revisit this at some point

      • feature requests being shared with POs

    • Documentation working group

      • met for the first time Wednesday

      • met with Marsha Bornstein (consultant) and convener from Blackwater

      • a lot needs to be written, planning for that (most being tracked in draft in Google Drive OLF)

      • interest in developing a glossary

        • need to collate glossary work from across SIGs, apps, etc.

        • contribute back to project a translation from Voyager, Sierra, Aleph and other systems to FOLIO

        • Erin will share around glossary for feedback, likely one of the first priorities to complete

        • Jira project so that documentation is part of the development project

        • this group needs to work on the Circulation Needs document - next step is how do we track this work and ensure it's documented, do people have ideas?

          • Cornell everyone on training group is doing 4 hours a week on FOLIO

          • Thursday meetings - time to review documents, or collective time to write documentation

          • Marc-breaking up into smaller working groups to write and review

          • Google technical writers style guide is what's being followed

          • but don't get nervous, as the working group can edit to follow the style guide

          • need for a roadmap for how to get through this in the next 4-6 months-Erin will work on this, play around with models

          • right now, if you want to pick up documentation, edit the Circulation documentation needs page and put your name next to it and we'll formalize this later

          • documentation intro to what's in the wiki, what's in Slack, what's in Jira, etc. onboarding is definitely lacking. Welcome to FOLIO; maybe a recording of welcome community member forum and a Q&A

          • roadmap-think about tasks that folks who don't have as much experience or time for documentation can help with