Bi-weekly summary of handbook changes

@team

Summary of merge requests for opencraft/documentation/public from 2025-04-29

Merge request: chore: update Jordan’s membership
Description:

Author: Arunmozhi P

For more details visit: #608.


@team

Summary of merge requests for opencraft/documentation/public from 2025-05-27

Merge request: chore: remove Douglas from team
Description:

Author: Arunmozhi P

For more details visit: #610.


@team

Summary of merge requests for opencraft/documentation/public from 2025-06-10

Merge request: feat: add dark theme toggle
Description: This MR adds dark theme and a toggle for it.

Author: Maxim Beder

For more details visit: #613.


Merge request: docs: add mention of tutor repo in list of core contributions
Description: ## Description

Add contribution to tutor repo to the list of changes eligible to be counted as Core Contribution.

Supporting information

Core Contributor - Work Scope #Tutor

Testing instructions

Visit the generated app link once the pipeline is complete and verify the changes reflect correctly.

Other information

Private Ref : BB-9757

Author: Kaustav Banerjee

For more details visit: #612.


Merge request: docs: add evidence forensic preservation
Description: This MR adds a new process how to do forensic evidence preservation.

Related task: Log in - OpenCraft

Signed-off-by: Gabor Boros gabor.brs@gmail.com

Author: Boros Gábor

For more details visit: #611.


Merge request: docs: Clarify Core Contributions processes.
Description: This MR clarifies how Core Contributions are to be identified, sets the expectation of who is to set labels (epic owners), and adds a process for verifying labels have been set (using the existing completion verification process by Sprint Managers.)

JIRA tickets: Log in - OpenCraft

Discussions: Improving the measurement of our contributions

Testing instructions:

  1. Visit the generated app link once the pipeline is complete
  2. Verify the text renders sanely and links are working correctly.

Author notes and concerns:

I was a little fuzzy on the conversation between @antoviaque and @Cup0fCoffee here, but I’ve done my best to distill my understanding in a way that is consistent with what I read between Xavier and upstream. Please let me know if it makes sense.

I’m tagging all Sprint Managers across all cells since it includes a tweak to one of your responsibilities.

Author: Fox Danger Piacenti

For more details visit: #609.


@team

Summary of merge requests for opencraft/documentation/public from 2026-05-26

Merge request: docs: update conference talk submission docs
Description: ## Description

This MR updates the existing documentation for the three-stage process for talk submission that worked very well this year.

Supplementary Information

Internal ticket: Log in - OpenCraft

Testing instructions

View the rendered app and check that the links and display make sense.

Author: Fox Danger Piacenti

For more details visit: #667.


Merge request: fix: discourse host url type [BB-10771]
Description: Adding AnyHttpUrl + str fails, this PR casts it to str first.

The third party package called: Pydiscourse expects str as host url and uses it directly to generate other urls. But we pass in AnyHttpUrl and it fails.

Private-ref: Log in - OpenCraft

Author: Navin Karkera

For more details visit: #666.


Merge request: feat: Add pinging guidelines documentation
Description: ## Description

Add basic guidelines and recommendations about ping people in messages.

Supporting information

Private-ref: Log in - OpenCraft

Testing instructions

  • build the docs, navigate to the new page
  • verify everything renders correctly
  • click all the links and verify they are all correct
  • verify accuracy of the information

Author: Christofer Chávez Carazas

For more details visit: #665.


Merge request: feat: Update scope of OSPR Liaison role.
Description: - Delete current scope (which has become obsolete).

Testing

Tickets

Reviewers

  • @samuelallan
  • @gabrieldamours

Author: Tim Krones

For more details visit: #662.


2 Likes

@navin Looks like everything back up and working. :slight_smile:

2 Likes

@team

Summary of merge requests for opencraft/documentation/public from 2026-06-23

Merge request: fix: remove accented character in cell data
Description: ## Description

Sprintcraft matches users between Jira and the opencraft.yml data by
full name. Rômulo’s name in Jira doesn’t have the accented ‘ô’ because
that made @-mentioning autocomplete more difficult in Jira. To fix
matching his user, we can likewise remove the accented character from
his name here.

Supporting information

Private-ref: Log in - OpenCraft

Testing instructions

Author: Samuel Allan

For more details visit: #668.


@team

Summary of merge requests for opencraft/documentation/public from 2026-07-07

Merge request: docs: update information about GitLab and GitHub
Description: ## Description

  • clarify that we still prefer GitLab for new projects wherever possible
  • clarify reasons to use GitHub
  • update instructions for adding teams to GitHub repos
  • general rewording for readability

Supporting information

See discussion on Migrate to GitHub?

Private-ref: Log in - OpenCraft

Testing instructions

  • verify this doesn’t change any policy, but just restates it for better clarity
  • verify the changes render as expected
  • verify everything is readable and accurate

Author: Samuel Allan

For more details visit: #670.


Merge request: docs: remove review timeline from task template
Description: ## Description

We almost never use this section, so it just adds noise to tickets.

If a specific timeline is really needed, then this should be mentioned
in the ticket and/or the “Due Date” field used.

Supporting information

Private-ref: Log in - OpenCraft

Previously raised at Feedback: following processes - #5 by paulo

Testing instructions

  • verify the changes render as expected
  • verify that it’s fine to remove this field

Author: Samuel Allan

For more details visit: #669.


Merge request: feat: add internal AI policy
Description: ## Description

This is a proposed AI policy for us to adopt at OpenCraft,
applying to OpenCraft members.

This is based on the new Open edX AI Contribution Policy
( .github/AI_POLICY.md at master · openedx/.github · GitHub ),
but with the following tweaks:

  • Clarify that we don’t directly put limitations on allowed AI tools, but that we must respect the upstream limitations for any Open edX related code, in case we want to upstream anything later.
  • Add a requirement to not use cloud AI models with private repos,
    since this could leak private information.
  • Adjust guidelines around what to do when you suspect the policy hasn’t
    been followed. We can’t just close a colleague’s PR and move on. ;)
    We need to account for colleague’s contributions as well as external
    contributions.

Also integrate this into the rest of the handbook, by linking to it
from the coding standards and security pages.

Note that the target audience is OpenCraft members; we may still want
a separate policy for external contributors to follow when contributing
to our projects.

Supporting information

See Adopt the Open edX AI policy?
for discussion.

Private-ref: Log in - OpenCraft (ticket) NOTE: this the ticket where the work began, but we may need a different ticket for logging time for reviews on this and further work.

Private-ref: Log in - OpenCraft (the ticket to discuss and review)

Testing instructions

  • verify the document renders correctly
  • verify the accuracy of the content
  • verify this is what we want

Author: Samuel Allan

For more details visit: #663.


@team

Summary of merge requests for opencraft/documentation/public from 2026-07-21

Merge request: feat: add renovate config
Description:

Author: Navin Karkera

For more details visit: #673.


Merge request: feat: add the “view page source” link to pages
Description: ## Description

I think we had this at some point (it’s referenced in #62), but it’s no
longer visible. According to

you need to add the edit or view actions to the theme features.

When I tested this, both the edit and view actions linked to the same
gitlab page (the view preview of markdown doc view), so I kept just the
view action.

Supporting information

Private-ref: BB-10597

Ref: #62

Testing instructions

  • build the site (or view the preview environment link)
  • visit a few pages
  • verify each page has a “view source” icon
  • verify that clicking this icon navigates to the correct corresponding page of the handbook in gitlab

Author: Samuel Allan

For more details visit: #672.


Merge request: fix: use unique preview env per branch
Description: ## Description

This ensures that the preview deployment for merge requests do not
overwrite each other.

Supporting information

Private-ref: Log in - OpenCraft

Fixes: #73

Test instructions

  • verify the CI in this PR deploys to a uniquely named environment
  • verify that re-running the compile job results in updating the environment url correctly
  • verify that other preview environments are unaffected

Author: Samuel Allan

For more details visit: #671.


Merge request: [STAR-4198] Update client offboarding documentation
Description: This MR updates the documentation for how to offboard clients who leave the company.

Test steps : TBD

Author: Gabriel D’Amours

For more details visit: #649.


@team

Summary of merge requests for opencraft/documentation/public from 2026-08-04

Merge request: feat: Update sustainability targets for Falcon and Bebop.
Description: … according to decisions made previously, in the context of the following

Tickets

Author: Tim Krones

For more details visit: #676.


Merge request: docs: update accounts information
Description: ## Description

Update accounts information based on Tim’s comment at

Supporting information

Private-ref: Log in - OpenCraft

Testing instructions

  • verify accuracy and readability of the new information

Author: Samuel Allan

For more details visit: #674.


@team

Summary of merge requests for opencraft/documentation/public from 2026-08-18

Merge request: docs: consolidate firefighting manager role docs
Description: ## Description

In
docs: expand the firefighting manager role (!678) · Merge requests · opencraft / documentation / public · GitLab,
we expanded the firefighting manager role. However, it turns out at some
point this was already part of the role, and the info on firefighting
managers was split across the roles page and the firefighting page.

Deduplicate the firefighting manager information into a single entry,
and edit for consistency.

Supporting information

Private-ref: comment in private doc

Private-ref: Log in - OpenCraft

Testing instructions

  • verify the changes render as expected and the links work
  • verify the information is accurate

Author: Samuel Allan

For more details visit: #679.


Merge request: docs: expand the firefighting manager role
Description: ## Description

Add responsibility to manage the Ops Review Draft doc and the Ops Review
forum thread.

The status quo is that FFs should coordinate between themselves to
update the doc and post to the thread. However, this task is often
neglected, perhaps due to not being a clear point of responsibility.

This hopefully will consolidate the responsibility and help ensure the
docs and update threads are updated more often, so we have more
visibility into incidents.

Supporting information

Private-ref: comment in private doc

Private-ref: Log in - OpenCraft

Testing instructions

  • verify the new information renders as expected, and is acceptable

TODO

  • find any firefighting manager tickets and update them to include this new information and link to the ops review draft doc and the forum thread
  • update the ops review draft doc as needed (it has instructions that may need updating)
  • update/remove the listaflow checklist item about “Post the incidents to the ops review forum thread”

Author: Samuel Allan

For more details visit: #678.


Merge request: docs: Update epic management doc with the budget extension subsection
Description: Description

Add a subsection dedicated to the budget extension, incorporating the lessons learned from this RCA.

Supporting information

Author: Christofer Chávez Carazas

For more details visit: #677.


Merge request: docs: use private docs redirects for docs files
Description:
private-ref: Log in - OpenCraft

Author: Kshitij Sobti

For more details visit: #675.


@team

Summary of merge requests for opencraft/documentation/public from 2026-09-01

Merge request: Mark Falcon as Generalist cell
Description: Update list of current cells and cell-specific rules to reflect the fact that Falcon has become a generalist cell.

Tickets

Author: Tim Krones

For more details visit: #680.