Versions Compared

Key

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

Quick Facts

  • 2 week sprint-aligned rotation within standard business hours based on this list.

  • @openedx/tcril-oncall is the GitHub group.

  • Ask for help if you need it!

Details

...

Info

Quick Facts:

Contents

Table of Contents

Schedule

On-Call Order

For exact dates, see the “Axim On-Call” Google calendar (Axim-internal).

(New Axim employees, you’ll need access to that calendar if you don’t have it already)

Past On-Calls

Expand
titlePast On-Calls

2022

2023

Details

🔔 What is axim-oncall?

  • A lightweight rotation of tCRIL Axim engineers, ensuring that someone is always responsible for responding to administrative requests from the community.

❌ What isn’t

...

axim-oncall?

  • Something that should be done outside of normal working hours.

  • Something that should affect weekends, holidays, or PTO.

  • Pager duty.

  • A designation that you need to handle ALL incoming community requests yourself.

📒 What are the responsibilities?

  • Respond to GitHub Requests within one business day.

    • Requests should automatically ping the @openedx/tcrilaxim-oncall GitHub group.

    • Assign yourself to the issue.

    • If you can’t resolve the request within a day, that is fine. Just give an “Ack” and a general timeline estimate.

    Ensure GitHub Requests get closed within a reasonable time span.

    • Feel free to delegate the actual work to other team members if you’re swamped.

    • Please note that users must also be added to the CLA check database. The specifics are documented here.

  • By the end of the sprint, ensure each GitHub Request is either:

    • closed, or

    • explicitly reviewed & handed off to the next on-call engineer at the beginning of the following sprint.

  • Respond to other pings to the @openedx/tcrilaxim-oncall group if they happen.

  • Keep an eye on the #openedx-transition and #tcril-2u-openedx channels. If tCRIL #ask-axim Slack channel. If Axim-oriented questions come up that nobody is responding to, bring them up in daily standup so we don’t forget about them.

⁉️ How do I handle requests?

🌀 How does the rotation work?

  • The Rotation order of the rotation is defined by at the list of people on the tCRIL Engineering homepage, excluding Ed and Jennatop of this page.

  • At the semi-weekly Planning Meeting, the on-call engineer switches to the next person in the order. Switching process:

    • Update the @openedx/tcrilaxim-oncall GitHub group.

    • The on-call engineer should audit their personal list of assigned issues. For issues that are related to on-call, the engineer can decide to “keep” the issue or “hand off” the issue to the next on-call engineer.

    • Make sure to update the assignee when handing off an issue.

  • If the on-call engineer is on PTO during their turn in the rotation, they should trade days with another engineer or trade the entire sprint. Don’t do on-call from vacation (smile)

🧠 Anything else to know?

  • Record any access changes or decisions

...

  • you make in GitHub issues. This will help us keep track of what changes we make and why.

  • To be on the rotation, you will need admin (“owner”) rights on the openedx GitHub organization, which will confer you admin-level rights to all repositories in the organization. Be judicious with these. In the majority of cases we should be abiding by all normal branch protection rules.

    • Appropriate uses of admin rights include:

      • Handling Axim GitHub Requests.

      • Fixing minutiae like out-of-date documentation links or typos in repository descriptions.

      • Merging without review or CI validation in order to fix CI itself or update repository metadata (openedx.yml).

    • Inappropriate uses include:

      • Merging app code without appropriate review and CI validation.

      • Adding or removing access rights when there is no corresponding Axim GitHub Request.