The FOLIO software development site is available at dev.folio.org.
FOLIO uses discuss.folio.org for asynchronous messaging. The Discuss site is a web forum with categories, topics, and posts. Use Discuss for asking questions and recording discussions that require more than a few sentences.
FOLIO uses wiki.folio.org to store documents with some permanence. FOLIO Special Interest Groups (SIGs), which are dedicated to specific functional areas or interests within FOLIO, have a space on the wiki.
Join the SIG meeting that is appropriate to the area where you are working: Community Calendars
Sign up for SIG mailing lists so you get all the emails sent to the group(s): https://ole-lists.openlibraryfoundation.org/ Please sign up for the PO distribution list: folio_pos
FOLIO Slack channels for real-time chat are available at folio-project.slack.com. Anyone may request to join the FOLIO Slack channels using an automated web form.
FOLIO UX designs can be viewed in the UX prototype. For some features, especially those in User Management and Resource access, this directory on FOLIO's google drive has more up-to-date mockups.
The FOLIO Google Drive has working documents for various project groups including most SIGs and the Product Council. There is a Product Owners sub-folder for our documents. Contact Anne L. Highsmith to gain access to the FOLIO Google Drive. Tell her you are a new FOLIO Product Owner.
FOLIO JIRA is the project's issue (bug, story etc.) tracker. Please sign up and then ask Cate Boerema or Jakub Skoczen for the ability to edit issues.
Each quarter release has an associated Weekly Status Report. For example FOLIO Q4 2018 Weekly Status Report. Product owners are asked to add notable changes, issues and risks directly to this report in the "Product Owner Updates" table. Please do add a comment here if one of your UXPROD features is added or removed from the release.
There is a Monday roundup meeting at the start of each sprint, 9:30-10:30 US ET, where POs present any new stories to the developers. For access to the coreteam calendar, which includes the sprint and roundup web conference information, please contact Cate Boerema.
Please include any mock-ups for your app in the shared Google UX folder, in a sub-folder for your particular app. For access to the UX folder, contact Cate Boerema.
(Note: Contact Cate Boerema for more information about these meetings/channels.)
JIRA (list of projects): https://issues.folio.org/secure/BrowseProjects.jspa?selectedCategory=all
If your team needs a project that is not on the list, please request from Cate Boerema or Jakub Skoczen
JIRA contains planning backlogs (epics and features) in a project called UXPROD. Development backlogs (e.g. user stories, bugs etc) are maintained in other projects (eg. mod-users and ui-users).
Higher level work is defined in epics and features in a JIRA project called UXPROD.
Epics are sub-projects in FOLIO. They are sized so that they require no more than one product owner and can be assigned to a single development team. Each quarter, the members of the FOLIO Product Council complete a survey in which they stack rank the epics by priority. This survey results in an epic "score" which helps us determine where to apply new product owners and development teams when they become available.
POs decompose epics into features based on their conversations with the SIGs. The idea is to capture larger work increments with as much unstructured description as is available. A well-scoped feature is something that is relatively self-contained so it can be prioritized independently. It should also be something that is “whole” enough to provide value on its own. So, “Manual License CRUD” might be a good feature while “View License Record” or “Validate License Data” would be stories. Stories should be linked to features as "related issues"
UXPROD features sometimes need to be split (e.g. when they are too large to fit into a quarterly release, they are not fully completed in time for the release and/or there are dependencies and blockers on some aspect of the feature). Instructions for splitting features:
1. Keep the original feature in the current release (assuming it was in the current release to begin with)
2. Add the label "split" to the original feature (this will allow us to see how many features in a release were split)
1. In the newly spun-off feature, clear out the early implementer rankings if they are populated
2. Make a note at the very top of the feature summary explaining that the feature was split off from another feature (this will be a clear indication to the early implementers and provide a link to the original feature so they can review and revise those rankings as well, if they see fit).
Make a note in the Weekly Status Report for the relevant quarter (the delivery quarter for the original feature) explaining how and why the feature was split. For example: FOLIO Q4 2018 Weekly Status Report
Umbrellas are another type of issue found in UXPROD. These are deprecated issues that have been superseded by epics or features, but are maintained for the purposes of tracking against the line items from the original (deprecated) v1 roadmap spreadsheet.
User stories are the product backlog items that are used by developers to guide their work. Stories are generally written by product owners. The format for user stories is:
Some example user stories:
Each story should have only one linked UXPROD feature.
The way "status" is used in JIRA differs depending upon whether you are working with development work items (like stories and bugs) or UXPROD features and epics. See below for the workflow for UXPROD features and epics.
The FOLIO wiki has a page in which manual testers and community members can report observations and issues which they aren't sure are actually defects. The page is Observations and Comments from Testers/Not Tickets page should be watched by all POs. If an observation has been added in relation to one of your apps, please review and follow-up as needed.
For who is working on what, please see the Directory of Product Owners by Area of Focus.
Questions about the Product Owner role or processes? Contact Cate Boerema.
To see the latest screen designs for each area go to FOLIO UX Designs.
To remain abreast of FOLIO news, visit folio.org/news. To remain abreast of FOLIO events worldwide, visit: events.folio.org.