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.