Skip to content

docs: add weight subtotals per working group and category#499

Open
LukaszRozmej wants to merge 2 commits into
protocolguild:mainfrom
LukaszRozmej:add-group-weight-totals
Open

docs: add weight subtotals per working group and category#499
LukaszRozmej wants to merge 2 commits into
protocolguild:mainfrom
LukaszRozmej:add-group-weight-totals

Conversation

@LukaszRozmej
Copy link
Copy Markdown
Collaborator

Summary

Surfaces each working group's total weight (sum of member weights) alongside the existing contributor count, and adds a total-weight figure to each top-level category summary. Helps readers see at a glance how much full-time-equivalent contribution each group/category carries — currently only contributor counts are shown, which under-represents groups with several 0.5-weight members and equally-represents groups where everyone is full-time.

What changed

  • Inline working-group header rows (23 groups): the previously-empty Weight cell now holds the bolded subtotal, e.g. | **Reth** (6 contributors) | **4.5** | [paradigmxyz/reth](...) |.
  • Where the group header IS the table's column-header row (Cryptography Research, Execution Layer Specs + Coordination, Dev/Testnets) or a soft section divider inside a continuing table (Consensus Layer Specs + Coordination): a new | _Group total_ | **N** | | row is inserted below it, since the Weight cell on the header row itself carries the column label.
  • Category summary bullets (4 lines): appended , N total weight after the existing M contributors count.

No member rows, contributor counts, links, or other content are modified.

Notes on rendering

GitHub's narrow rendered view (and the readthedocs build) was a constraint, so I avoided widening any column. The subtotal lives in the existing Weight column where it aligns visually beneath each member's weight.

Stale numbers in the source (not touched by this PR)

While computing the subtotals I noticed a few contributor counts have drifted from the actual member rows. Listing here so they can be fixed in a follow-up (didn't want to expand this PR's scope):

  • Reth group header says "6 contributors" but lists 7 rows.
  • WAYFINDING category summary says "38 contributors", groups sum to 40.
  • CLIENT IMPLEMENTATIONS category summary says "109 contributors", groups sum to 114.
  • UPGRADE DELIVERY category summary says "29 contributors", groups sum to 30.

The total-weight numbers added here are computed from the actual member rows, so they are accurate even where the stale counts disagree.

Surfaces each working group's total weight (sum of member weights)
alongside the existing contributor count, and adds a total-weight
figure to each top-level category summary.

- Inline group header rows: the previously-empty Weight cell now
  holds the bolded subtotal.
- Where the group header IS the table's column-header row (or a
  soft section divider inside a continuing table), a new
  "Group total" row is inserted below it.
- The four category summary bullets gain ", N total weight" after
  the existing contributors count.

No member rows, contributor counts, or links are modified.
- Three working groups (Cryptography Research, Execution Layer Specs
  + Coordination, Dev/Testnets) and one soft section divider
  (Consensus Layer Specs + Coordination) previously occupied the
  table's column-header row, which meant their Weight cell was taken
  by the "Weight" column label rather than a subtotal. They now sit
  as ordinary inline rows below a generic `**Group** | **Weight** |
  **Contributions**` header, matching the format already used by the
  CONSENSUS CLIENTS / EXECUTION CLIENTS tables.
- The placeholder "Group total" rows added in the previous commit are
  removed; subtotals now live directly in each group's own row.
- Reth's contributor count corrected from 6 to 7 — the source already
  listed 7 member rows.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants