Versions Compared
compared with
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Overview
Status | |||||
---|---|---|---|---|---|
|
|
A development dependency (for purposes of this page) is when a development effort requires requirements/work/support from more than one team. As FOLIO continues to grow, it is important that we have a common understanding for how to handle such dependencies. The key to successful handling of dependencies - Communicate as early and often as possible.
Dependency scenarios
- Changing workflow (Example: )
- Shared apps/workflow (Example: )
- Shared backlog (Example: )
- Require development from another team (Example: )
- Developing in a module that is owned by another team (Example: )
- Developing in a module where multiple teams contribute code (Example: )
- New development team (Example: )
- Integration (Example: )
Best Practices for handling dependencies successfully
Still vetting/refining requirement.
- No change to current process for validating requirements AND so assume (if applicable) that requirements have been reviewed and refined with respective SIG(s)
- PO (with a dependency) > Please talk with the PO(s) that own the module/app/workflow. Provide the following details
- High level overview of the change
- Provide a link to the Jira feature/user story/bug that documents the requirement(s) and user expectation(s)
- Recommended timing for this action: as soon as you have an understanding of the requirement and ideally before release scope definition deadline.
- High level overview of the change
- Outcome
- Agreed upon next steps including who owns writing or implementing requirement and timing
- Agreement to peer review requirements to ensure alignment
- Communicate <-> Collaborate.... Communicate <-> Collaborate
Team with dependency is planning/preparing for release to implement
- PO and Dev lead (with a dependency) > Please talk with the PO(s)/Dev lead(s) that own the module/app/workflow. Provide the following details.
- High level overview of the change High The module owner team gives a high level introduction of the module/suite of modules for the developers who is to start working in these existing modules
- High level overview of the change
- Provide a link to the Jira feature/user story/bug that documents the requirement(s) and user expectation(s)
- Technical design
- Recommended timing for this action: as soon as you have an understanding of the requirement and ideally before release scope definition deadline.
- Outcome
- Technical design and approach alignment
- Development efforts per team including timing for when dependencies will be ready
- Testing approach (including QA test coverage)
- PR reviews alignment
- Definition of done alignment
- Document agreements and implementation/testing plan
- Communicate <-> Collaborate.... Communicate <-> Collaborate
During development and testing
- Jira epic/feature should link to all dependencies
- Recurring meetings between POs/QAs/Dev leads to check-in regarding development and testing progress.
- Attend applicable development ceremony activity (e.g. daily stand-up, sprint demo, etc.)
- POs/QAs responsible for module/app to participate in PO/QA/SME verification at the end of each applicable sprint.
- Communicate <-> Collaborate.... Communicate <-> Collaborate
Before Bugfest
- e2e testing has been done before Bugfest (at least 2 weeks)
- Demo has been done that includes applicable SMEs/POs/QAs/Devs to ensure alignment (at least 3-4 weeks before Bugfest)
- Communicate <-> Collaborate.... Communicate <-> Collaborate
Ideas for communicating across multiple teams (please add your thoughts)
- Dedicated slack Slack channel for more complex dependency management management, or the SIG slack channels
- Wiki page(or meeting notes) that is the source of truth and includes a decision log (when applicable)
Questions - please post your questions in this column
- Is there a dependency? What if I'm not sure?
- When multiple teams/POs work within a broad area, how do I know which team/PO to approach? (E.g. I need to do some work in Holdings related to Receiving in Acquisitions. I know who the MM POs are, but which PO and which team specifically?)
- What if it's a general area where no POs or teams exist, but which impacts multiple teams? (E.g. security)
- What if my team is developing something that may be of use or interest to other teams and want to make those teams aware of this new functionality?
- How do I prioritize the work with another team against the work set for my team?
- What is the SIG's role with dependencies?
- What are developer's responsibilities?