Convert repetitive list pages to scannable tables#13
Merged
Conversation
Three Operations pages presented uniform, repetitive content as long runs of headings/collapsibles that force scrolling to compare entries. Restructure them into GitBook tables for at-a-glance scanning: - roles.md: 23 role headings (H3 + one sentence) become three grouped tables (MSP technical, vendor technical, shared support). Descriptions preserved. - categories-of-tools.md: seven <details> collapsibles become one Category / Examples / Job-to-be-done comparison table. Intro and the "how these tools work together" prose kept. - common-regulations-affecting-msps.md: add an "at a glance" summary table (Regulation / Scope / Applies to) above the existing detailed sections, which vary too much in depth to flatten. Also add frontmatter description: to all three pages. Content preserved — this is a formatting/structure change, not a rewrite. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VUCiLahfydRghmenGbw5Sa
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What & why
Second slice of the GitBook-formatting audit (follow-up to the merged wayfinding-cards PR #12). Several Operations pages present uniform, repetitive content as long runs of headings or collapsibles — you have to scroll and hold each entry in your head to compare them. This PR restructures the three worst offenders into GitBook tables so they can be scanned at a glance.
Changes
roles.mdH3+ one sentence (~100 lines)categories-of-tools.md<details>collapsiblescommon-regulations-affecting-msps.mdAlso added a frontmatter
description:to all three pages.Scope
Formatting/structure only. Role and tool descriptions are preserved; the regulations page's detailed prose is untouched (the table is additive, since those entries vary too much in depth to flatten without losing content).
Verification
<details>left behind.🤖 Generated with Claude Code
Generated by Claude Code