Improve Resources section formatting: embeds, tables, and metadata#14
Open
cipp-ashe wants to merge 2 commits into
Open
Improve Resources section formatting: embeds, tables, and metadata#14cipp-ashe wants to merge 2 commits into
cipp-ashe wants to merge 2 commits into
Conversation
The Resources podcast/blog pages were bare "Name / [blurb] / **Link:** url"
lists, with most blurbs still the literal placeholder [blurb]. Replace the
plain link lines with GitBook {% embed %} blocks, which render each URL as a
rich card (pulling the destination's own title and description) — so the
entries look finished without inventing copy about third-party sites.
- business-resources/podcasts-and-webinars.md: 8 podcasts as embed cards
under named headings; the one real blurb (Business of Tech) kept.
- business-resources/blogs-and-books.md: Auvik + Jay McBain entries as embeds.
- technical-resources/blogs-and-books.md: RMM comparison sheet + CyberDrain
as embeds; existing blurbs kept.
- technical-resources/podcasts-and-webinars.md: was completely empty; add a
short note + a content-ref to the populated Business Resources list.
Added frontmatter description: to all four pages. All original URLs preserved.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VUCiLahfydRghmenGbw5Sa
Extends the Resources formatting pass to the Communities leaf pages, which
are link-lists but not good {% embed %} candidates (login-walled social
groups, or richly structured entries embeds would flatten):
- social-media-communities.md: bare Name/blurb/Link list becomes a
Community / Platform / Focus / Link table. Descriptions preserved.
- peer-groups.md: add an "at a glance" summary table (Peer group / Region /
Best for / Link) above the existing detailed entries.
- forums-and-chat-communities.md: normalize inconsistent heading levels
(mixed ## and #### plus a stray "6.") to a consistent ### per community.
Added frontmatter description: to the two pages that lacked one. No community
entries added or removed, so the community_list JSON mirror is untouched.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VUCiLahfydRghmenGbw5Sa
cipp-ashe
changed the title
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
Third slice of the GitBook-formatting audit (after wayfinding cards #12 and scannability tables #13). This PR reformats the Resources pages so their link-lists render as finished, scannable content instead of bare URLs — using the right GitBook block for each case.
Changes
Public link-lists →
{% embed %}cards (rich cards pulling each site's own title/description, so placeholder[blurb]entries look finished without inventing copy):business-resources/podcasts-and-webinars.md— 8 podcasts as embed cards.business-resources/blogs-and-books.md— Auvik + Jay McBain entries.technical-resources/blogs-and-books.md— RMM comparison sheet + CyberDrain.technical-resources/podcasts-and-webinars.md— was empty; added a note +content-refto the populated Business list.Communities pages → tables / heading fixes (these are not good embed candidates — social links are login-walled; peer-group entries are structured and embeds would flatten them):
social-media-communities.md— bare list → Community / Platform / Focus / Link table.peer-groups.md— added an "at a glance" summary table above the existing detailed entries.forums-and-chat-communities.md— normalized inconsistent heading levels (mixed##/####+ a stray "6.") to a consistent###per community.Added a frontmatter
description:to every one of these pages that lacked one.Scope
Formatting only. All original URLs and blurbs preserved. No community entries added or removed, so the
community_listJSON mirror is untouched.Verification
content-refresolves; JSON unchanged.Flagged for a separate follow-up (content, not formatting)
While reformatting I found the
community_listJSON is stale and out of sync with the prose: it holds 17 entries (a superset spanning all three community pages) while the forums page lists 6, several links diverge (MSPGeek, Spiceworks, TTD), and one is a placeholder —discord.gg/0123abc456def. Reconciling it needs canonical-link decisions, so I left it out of this formatting PR.🤖 Generated with Claude Code