Skip to content

Update number of pages in the handbook.

Jessica Reeder requested to merge jessicareeder-master-patch-22747 into master

Why is this change being made?

Per MR !88323 (merged), the handbook is currently 2,271 pages of text. This MR changes the text in the handbook main page to align with the new calculation.

Some context from the linked MR:

Through evaluating our handbook's quantitative data I learned two interesting things:

  1. We are actually including images in the word count, so the numbers are way off (more than double). This was corrected in a draft MR at !88252 (closed)
  2. We considered page count as the number of printed pages going with analogy of printing off a physical handbook.

Through our discussion in Slack https://gitlab.slack.com/archives/C3MAZRM8W/p1628795666227900 we agreed to shift to tracking the number of handbook web pages instead. This is a better representation of the number of contexts/subjects within our handbook.

This MR updates our page count. It preserves the word count column, but with corrected numbers that include only markdown (content) files. Additionally, it switches to quarterly data as the previous dates seem arbitrary. Also included is a command to get historical numbers if necessary.

As of August 1st we have over 2,000 pages in our handbook

Author Checklist

  • Provided a concise title for the MR
  • Added a description to this MR explaining the reasons for the proposed change, per say-why-not-just-what
    • Copy/paste the Slack conversation to document it for later, or upload screenshots. Verify that no confidential data is added.
  • Assign reviewers for this change to the correct DRI(s)
    • If the DRI for the page/s being updated isn’t immediately clear, then assign it to one of the people listed in the "Maintained by" section in on the page being edited.
    • If your manager does not have merge rights, please ask someone to merge it AFTER it has been approved by your manager in #mr-buddies.
  • If the changes affect team members, or warrant an announcement in another way, please consider posting an update in #whats-happening-at-gitlab linking to this MR.
    • If this is a change that directly impacts the majority of global team members, it should be a candidate for #company-fyi. Please work with internal communications and check the handbook for examples.
Edited by Jessica Reeder

Merge request reports