Bi-weekly summary of handbook changes

@team

Summary of merge requests for opencraft/documentation/public from 2024-04-02

Merge request: chore: remove Sid Verma from the team
Description:

Author: Arunmozhi

For more details visit: #568.


Merge request: docs: Remove written checklist in favor of Listaflow template link.
Description: This PR removes the ‘Finding work’ checklist in favor of the ported template to Listaflow.

JIRA tickets: Log in - OpenCraft

Testing instructions:

  1. Check the automatic app build link to verify this built correctly
  2. Verify the checklist template in Listaflow to verify it ports the checklist well.

Author: Fox Piacenti

For more details visit: #567.


Merge request: docs: update the review checklist [BB-8472]
Description:

Author: Demid

For more details visit: #566.


@team

Summary of merge requests for opencraft/documentation/public from 2024-04-16

Merge request: [STAR-3464] Update cell-specific sustainability ratios for Falcon and Bebop
Description: … to match chosen targets for 2024.

See Log in - OpenCraft for details.

Rendered changes

Author: Tim Krones

For more details visit: #570.


@team

Summary of merge requests for opencraft/documentation/public from 2024-05-28

Merge request: [STAR-3371] Document recruitment criteria and coordination requirements
Description: Tickets

Testing

Check that formatting looks correct in rendered version of changes.

Reviewers

Author: Tim Krones

For more details visit: #569.


@team

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

Merge request: feat: add kimoy to the team
Description:

Author: Arunmozhi P

For more details visit: #573.


Merge request: docs: Properly document responsibilities for keeping Serenity’s epic schedule up-to-date.
Description: Tickets

Testing

  1. Check that formatting looks correct in rendered version of changes.

Reviewers

Author: Tim Krones

For more details visit: #572.


1 Like

@team

Summary of merge requests for opencraft/documentation/public from 2024-08-06

Merge request: feat: Move Navin from Bebop to Falcon.
Description: See forum conversation for context.

Tickets

Testing

Author notes

  • Work on reassigning backup position for sprint manager role is still in progress. Corresponding changes to the handbook will be made via a future PR once we confirm a new assignee.

Author: Tim Krones

For more details visit: #575.


@team

Summary of merge requests for opencraft/documentation/public from 2024-09-03

Merge request: feat: remove yusuf from Falcon
Description:

Author: Arunmozhi P

For more details visit: #580.


Merge request: docs: Assign backup for Sprint Manager role.
Description: Follows up on !575.

@artur_gaspar agreed to taking the backup position for Bebop’s Sprint Manager role. This PR is making that official.

Author: Tim Krones

For more details visit: #578.


Merge request: [STAR-3686] docs: Improve wording and linkage in BizDev role definition.
Description: This merge request addresses a few notes proposed by Doug and adds in links to several items in the Business Development Role definition to other parts in the handbook which detail the relevant processes/items.

JIRA tickets: Log in - OpenCraft

Discussions: https://docs.google.com/document/d/1vriPR8EQ0p9AaCkQsLAkoqidPmsV8BUMAMwafzPgd_E/edit

Sandbox URL: See the ‘View app’ button generated below on this MR.

Testing instructions:

  1. Read through the changes and review.
  2. Check the rendering of the page by checking the ‘View app’ button below.

Author: Fox Piacenti

For more details visit: #576.


@team

Summary of merge requests for opencraft/documentation/public from 2024-09-17

Merge request: [STAR-3593] docs: SLA moved to ToS.
Description: Recent updates to the Terms of Service place the SLA into them directly. This MR removes the old copy of the SLA to prevent it from being duplicated and getting out of sync.

JIRA tickets: Log in - OpenCraft

Testing instructions:

  1. Check the changes via the ‘view app’ link below.

Author: Fox Piacenti

For more details visit: #582.


@team

Summary of merge requests for opencraft/documentation/public from 2024-10-01

Merge request: Move Daniel from Bebop to Falcon
Description: See forum conversation for context.

Tickets

Testing

Author notes

  • This PR also removes cell-specific vacation rules for Falcon: The cell is back to five members now, so the default holiday buffer of 20% correctly captures that we want to limit time off to one person at a time (except for the overlap of 1 day/week that we tolerate by default).

Author: Tim Krones

For more details visit: #583.


Merge request: Kimoy/sales updates
Description: This merge request addresses a few changes that should be made after re-reviewing the sales section of the handbook, now that I am more familiar with the processes.

JIRA tickets: Log in - OpenCraft

Discussions: https://docs.google.com/document/d/19QE5Motx4Yt3evlll8_GNLrXv2xookLMTBtmnFzvm2I/edit

Testing instructions:

  1. Read through the changes and review.

Author: Kimoy Beckford

For more details visit: #579.


Merge request: [STAR-3422] Consolidate and improve templates for epic updates
Description: Also:

  • Update scope of epic planning role to include checking epic updates for info about ongoing and future work.
  • Change deadline for posting epic updates, to give epic owners a chance to take their time and do it more calmly.
  • Update definition of epic owner role with some additional details/pointers about scheduling as well as budget and progress tracking.
  • Explicitly document division of responsibilities for budget tracking.
  • Move new epic update template from List of roles page to page on Epic Management.

Tickets

Documentation updates

Reviews

… and corresponding subtasks.

Testing

Author: Tim Krones

For more details visit: #574.


@team

Summary of merge requests for opencraft/documentation/public from 2024-10-15

Merge request: feat: adds saksham to team
Description:

Author: Arunmozhi P

For more details visit: #577.


@team

Summary of merge requests for opencraft/documentation/public from 2024-10-29

Merge request: feat: adds Matheus, removes Saksham and Kimoy from the team
Description:

Author: Arunmozhi P

For more details visit: #585.


Merge request: Quick update to blog process
Description: This MR proposes minor updates to blog.md, to reflect the current processes around publishing blog posts.

Test instructions:

  • Read through the changes, check content accuracy and syntax
  • Check that the changes render correctly (“View app”)

Author: Gabriel D’Amours

For more details visit: #584.


Merge request: docs: update security policy
Description: This MR updates the security policy of OpenCraft, based on the security improvement proposal we have for 2024.

Author: Boros Gábor

For more details visit: #571.


1 Like

@team

Summary of merge requests for opencraft/documentation/public from 2024-11-12

Merge request: feat: remove moncef from team
Description:

Author: Arunmozhi P

For more details visit: #591.


Merge request: Replace absolute urls with relative paths
Description: Replaced absolute urls with relative paths in the Root cause Analysis procedure

Author: Alison Hugo

For more details visit: #590.


Merge request: Add RCA procedure
Description: Added a procedure for performing root cause analyses (RCAs)

Tickets

Testing

Author: Alison Hugo

For more details visit: #589.


Merge request: docs: Change social chat documentation to reflect current processes.
Description: This MR updates the social chat documentation to include the changes as discussed in this thread.

JIRA tickets: Log in - OpenCraft

Testing instructions:

  1. Check the app preview
  2. Verify the contents and formatting look sane.

Author: Fox Piacenti

For more details visit: #586.


Merge request: docs: Add Core Contributor and Product Review requirements to estimates.
Description: This MR adds in the specific requirements for CCs involvements in the estimation and review process, as well as the requirement that projects be made as contributions and be reviewed as such.

JIRA tickets: Log in - OpenCraft

Discussions: Upstreaming, forks, plugins & themes - #6 by maxim

Testing instructions:

  1. Read through the changes
  2. View the changes in the rendered app

Author: Fox Piacenti

For more details visit: #581.


1 Like

@team

Summary of merge requests for opencraft/documentation/public from 2024-11-26

Merge request: docs: Add holiday vacation process.
Description: This merge request documents the holiday vacation process, previously unwritten, and documents how to handle a team-wide auto-responder for contact@ on the days when no one may be monitoring that address.

JIRA tickets: Log in - OpenCraft

Testing instructions:

  1. Check the prebuilt version of the handbook to verify it looks right.

Author notes and concerns:

  1. This assigns a previously unassigned responsibility to the administrative specialist (cc @gabrieldamours .) Please comment and verify this is OK or if you have any objections.
  2. It also assigns a responsibility to whoever primarily monitors a mailing list, so the business development specialist or the administrative specialist in most cases.

Author: Fox Piacenti

For more details visit: #592.


Merge request: Add conference planning guide
Description: Added a conference planning guide for future conference epic owners

Tickets

Testing

Author: Alison Hugo

For more details visit: #588.


@team

Summary of merge requests for opencraft/documentation/public from 2024-12-10

Merge request: Change Gramlee proofreading email
Description: Changed Gramlee’s proofreading email address for future document proofreading.

Jira ticket

Author: Cassie Zamparini

For more details visit: #594.


Merge request: docs: Remove obsolete content from definitions of Community Relations roles
Description: First batch of changes for tickets listed below.

Just removing obsolete content for now, and fixing some links and typos.

Testing

Tickets

Reviewers

Author: Tim Krones

For more details visit: #593.


@team

Summary of merge requests for opencraft/documentation/public from 2024-12-24

Merge request: feat: adds abdur to the team
Description:

Author: Arunmozhi P

For more details visit: #596.


@team

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

Merge request: [STAR-3791] moving info from private docs
Description: This MR introduces moves some information from the private accounting documentation to the “Team Compensation” section of the handbook.

Testing instructions:

  • Review changes and check for accuracy and syntax
  • Check that the changes render correctly

Author: Gabriel D’Amours

For more details visit: #597.


Merge request: docs: Update mailing list autoresponder link.
Description: This MR updates the link for mailing list autoresponder configuration after our recent migration.

JIRA tickets: Log in - OpenCraft

Testing instructions:

  1. Check the app preview link and verify everything rendered sanely and the links are good.

Author: Fox Piacenti

For more details visit: #595.


@team

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

Merge request: chore: remove Abdur from team member list
Description:

Author: Arunmozhi P

For more details visit: #598.


@team

Summary of merge requests for opencraft/documentation/public from 2025-02-18

Merge request: chore: remove matheus and add jordan as BDS
Description:

Author: Arunmozhi P

For more details visit: #599.


@team

Summary of merge requests for opencraft/documentation/public from 2025-03-18

Merge request: docs: remove/replace mentions of OCIM
Description: ## Description

This PR remove or replaces mentions of OCIM in our public handbook

Testing instructions

Please provide detailed step-by-step instructions for testing this change.

Other information

Private Ref : BB-9386

Author: Kaustav Banerjee

For more details visit: #603.


Merge request: fix: Accidental early return on zoom account loop.
Description: This pull request fixes a bug in the zoom migration code where only the first zoom account might be honored due to an early return.

JIRA tickets: Log in - OpenCraft

Testing instructions:

  1. make install_prereqs
  2. Copy all the CI variables locally in an .env file (not because .env is respected but because it isn’t tracked by source control) in this manner:
export GOOGLE_API_CREDENTIALS=$(
cat <<'END_HEREDOC'
{
  "creds_or_token": {"token": "token-here", "refresh_token": "refresh-token-here", "token_uri": "https://oauth2.googleapis.com/token", "client_id": "client-id-here", "client_secret": "secret-here", "scopes": ["https://www.googleapis.com/auth/drive.file", "https://www.googleapis.com/auth/drive.metadata"], "expiry": "expiry-date"},
  "scopes": ["https://www.googleapis.com/auth/drive.file", "https://www.googleapis.com/auth/drive.metadata"]
}
END_HEREDOC
)
  1. source .env to load the CI variables (make sure you set them all)
  2. Add print statements to verify the loop
  3. Comment out the email line, since the firewall will prevent this, apparently
  4. make migrate_zoom_meetings
  5. Once verified, delete the .env file

Preferably, if you have access to some, use test credentials instead of the real CI ones. Or trust me bro, it’s a one line obvious fix. How broken could it be?

Author: Fox Danger Piacenti

For more details visit: #602.


Merge request: docs: Clarify product team review role.
Description: This MR clarifies the role of product in the discovery process, and makes it clear that its involvement is not merely for adding a single line item concerning the design phase, but is also critical to the format and scope of the document.

JIRA tickets: Log in - OpenCraft

Discussions: Updates to Discovery Instructions - #11 by Fox

Merge deadline: “None” if there’s no rush, “ASAP” if it’s critical, or provide a specific date if there is one.

Testing instructions:

  1. Check the built version of the documentation to make sure the formatting is sensible.

Author: Fox Danger Piacenti

For more details visit: #601.


Merge request: [STAR-2983] Update info about non-billable accounts to reflect recent category changes.
Description: In the context of STAR-3920 we updated the categorization of non-billable cell and non-billable non-cell accounts; see this comment for details.

This PR updates the handbook to reflect the changes.

It also fixes some typos and removes some outdated information found along the way.

Testing

Tickets

Reviewers

  • @gabrieldamours

Author: Tim Krones

For more details visit: #600.


1 Like

@team

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

Merge request: docs: add bizdev support engineer role and maintenance plan info
Description: ## Description

Adding the new BizDev Support Engineer role to the list of Roles and Expectations page.

Supporting information

Jira Task: https://tasks.opencraft.com/browse/STAR-4032

Author: Jordan Saniuk

For more details visit: #606.


Merge request: docs: Update info about cell-specific sustainability ratios to match 2025 targets.
Description: We set cell-specific sustainability targets for 2025 via STAR-3920. This PR applies them to the handbook.

Tickets

Author: Tim Krones

For more details visit: #605.


Merge request: chore: fixed incorect account name
Description: ## Description

In !603, an active account name was incorrectly changed. This PR fixes that.

Other information

Private Ref: BB-9386

Author: Kaustav Banerjee

For more details visit: #604.


@team

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

Merge request: doc: add lead rubric to handbook lead prioritization
Description: ## Description

Add the new outbound lead rubric to the Lead Prioritization page of the handbook.

Supporting information

Jira Task: https://tasks.opencraft.com/browse/STAR-4114

Author: Jordan Saniuk

For more details visit: #607.