2025-07-21 BTR Meeting notes

2025-07-21 BTR Meeting notes

All public Working Group meetings follow the https://openedx.atlassian.net/wiki/spaces/COMM/pages/4324360195

 Date

Jul 21, 2025

 Participants

  • @Maria Grimaldi

 Goals

  •  

 Discussion topics

Item

Presenter

Notes

Item

Presenter

Notes

Highlights & Wins (Documented for the Playbook)

 

I. Context, data, and highlights 📈

  • Teak.1 master branch was cut on June 26, about 3 weeks later than planned.

  • We reached 96.9% test completion, largely thanks to the test-a-thons.

  • The branch cut was delayed slightly to land some last-minute PRs.

II. Successes and achievements 🏅

  • Community stepped up big time to help with triage and testing.

  • Async check-ins surfaced blockers early without needing more meetings.

  • BTR-labeled issues helped bring new contributors into the process.

  • Test-a-thons drove completion, even if the last one had lower turnout.

  • Issue transfer flow (BTR ➝ maintainers) made collaboration smoother.

III. We should keep ✅

  • Toggle automation for waffle flag tracking (huge improvement!)

  • Test-a-thons as structured checkpoints to boost coverage

  • Async check-ins before release cut

  • BTR onboarding using well-labeled issues

  • Issue flow: moving failures to source repos to increase visibility

📝 We’ll skip live discussion here, but this section will be documented and carried over to future release planning.

What Should We Do Differently? ❌



What We Want to Improve

Testing Process and Spreadsheet

  • Add a column in the test spreadsheet to indicate if a test requires technical knowledge (e.g., developer or operator).

  • Make setup instructions easier to follow by linking to http://openedx.org docs, instead of duplicating the steps in the sheet.

  • Indicate which tests are related to each other, so testers can run several once they’ve done the setup.

  • Improve test case ID generation:

    • Base it on spreadsheet row numbers or use separate tabs per persona.

    • Keep references to old IDs so we don’t break existing links in GitHub issues.

  • Don’t delete deprecated tests. Mark them clearly (e.g., using strikethrough or color).

  • Add a warning or tip about using views instead of filters in the spreadsheet, so people don’t accidentally hide tests.

  • Encourage contributors to write their own tests using the guides already available in the BTR wiki.

Documentation

  • Continue linking tests to the proper http://openedx.org documentation.

  • Improve those docs where needed—make sure they explain required permissions, where to click, and what to expect.

  • Avoid duplicating instructions in the spreadsheet. Just link to the docs.

Post-Release Tasks

  • Add a new step to the post-release checklist to create the correct branches in Transifex and notify the Transifex maintainer.

  • This was missed in the last release and had to be fixed afterward.

Bug Triage and Issue Management

  • Focus on fixing high-priority issues during the 0.1, 0.2, and 0.3 patch releases.

  • Community members and maintainers can help with medium and low priority issues.

  • Keep transferred issues visible on the BTR board so we can track if they reappear across releases.

  • Avoid deleting duplicate issues that show up in multiple releases—this helps us know if a bug has gone unresolved for a long time.

  • Before closing an issue, reach out to the person assigned to it to confirm it’s still active.

Frontend Capacity

  • Many of the current issues are in authoring MFEs, but the bug triage team is mostly backend-focused.

  • We need more frontend contributors, or we should involve frontend folks in the triage process.

Open Questions and Ongoing Discussions

 

Tools for Managing the Testing Process

  • The test spreadsheet works well for many testers, especially those who aren’t technical.

  • Still, some tasks (like test creation and issue tracking) might be easier in GitHub or with light automation.

  • One idea is to explore ways to sync metadata between GitHub and the test sheet—without replacing the spreadsheet entirely.

Keeping Test Cases Up to Date

  • Any product change can affect multiple tests, but we don’t currently track this well.

  • One idea is to have the product liaison ask contributors what parts of the platform they changed, so we can check if related tests need to be updated.

  • This process needs more thought: who owns it, how it would work, and how much effort it takes.

Feedback from Users on Older Releases

  • Some people are stuck on old versions of Open edX because of bugs or missing features.

  • We could reach out to those users to ask what’s blocking them.

  • This could help us identify missing tests or things we should cover better in the future.

Reviewing Past Retrospective Items

  • There are still open issues from past retrospectives (like Redwood and Sumac).

  • These should be reviewed before we add new action items from this cycle.

  • We may need to close or reassign old items that are no longer relevant.

Board Maintenance and Workflow

  • The BTR issue board keeps growing and is harder to manage.

  • Suggestions included:

    • Contacting assignees of old issues to see if they’re still planning to work on them.

    • Asking for a timeline or commitment. If none, close or reassign the issue.

  • The test failure board is also getting harder to manage. There’s no clear strategy for reviewing and prioritizing those items across releases.

  • Maria will bring this up at the Maintainers Working Group this week.

  • The team agreed to set up a working session before the next BTR meeting to clean up the board and follow up on open issues.

Role Clarity and Tagging

  • Roles for the next release are still being finalized.

  • Amir Aoub is expected to take over as product liaison.

  • Antonella will likely stay on as testing coordinator.

  • For now:

    • Use the product-managers GitHub group to tag product-related issues.

    • Tag Antonella for questions about the test sheet or testing coordination.

Contributor Experience

  • GitHub is still intimidating for some testers.

  • There are instructions on how to report issues or open pull requests, but we’re not sure how helpful they are to new testers.

  • We should follow up with testers from the last cycle to ask how the tools worked for them, and what could be improved.

Next Steps

 

  • @Maria Grimaldi

    • Schedule a short working session before the next BTR meeting to:

      • Review and clean up unresolved items from past retrospectives.

      • Confirm who will take each role in the next cycle.

      • Turn action items from this meeting into GitHub issues.

    • Reach out to recent testers and people using older releases to get feedback on blockers, workflows, and documentation.

    • Bring the test failure board topic to the Maintainers Working Group and discuss how it should be handled long-term.

    • Think about how to continue improving the http://openedx.org docs and the test spreadsheet experience.

 Action items

 Decisions