Skip to content

site: 3-part blog series on what's new since NBI 4.8#353

Open
pjdoland wants to merge 2 commits into
plmbr:gh-pagesfrom
pjdoland:docs/blog-5x-series
Open

site: 3-part blog series on what's new since NBI 4.8#353
pjdoland wants to merge 2 commits into
plmbr:gh-pagesfrom
pjdoland:docs/blog-5x-series

Conversation

@pjdoland
Copy link
Copy Markdown
Collaborator

Summary

Adds a three-part feature deep-dive series to the blog, one post per day across 5/26 to 5/28. These complement the existing v5.0.0 release-notes post by going deeper on themes, in the narrative style of the 2025 deep-dives (not release notes). Together they cover the user-facing surface that shipped in 5.0.0 and 5.0.1.

Date Post
2026-05-26 Managing Claude's toolbox: Skills, MCP, and Plugins
2026-05-27 An agent-aware chat sidebar
2026-05-28 Coding-agent launchers, Codex, and a hardened platform

Post 1 covers the three new top-level Settings tabs (Skills, Claude MCP Servers, Claude Plugins) and the force-on / force-off / user-choice admin-policy model. Post 2 covers the agent-aware sidebar work: progress feedback during long turns, refresh-open-files-on-disk, workspace files as @-mention pointers, terminal drag-drop, AI-generated links opening in a new tab, and the first-run tour. Post 3 covers the coding-agent launcher tiles, Codex chat models routing through the /responses endpoint, dynamic Copilot model discovery, the accessibility pass, and the security hardening plus the fastmcp to mcp swap.

Conventions followed

  • Deep-dive front matter: layout: post, /blog/<slug>/ permalink, description, Pacific-time date. Not archived, so they appear on the main blog index (and sort above the 5/22 release post).
  • Sibling cross-links via {{site.baseurl}}{% post_url ... %} and a series-nav footer on each post.
  • Six raw UI screenshots (no chrome) under assets/images/whats-new-5x/, embedded with root-relative /assets/... paths to match the post-rename site (baseurl: /).
  • No em dashes; American spelling; no inline PR numbers (matching the existing blog voice).

Production

Drafted by five expert-writer-persona agents (three post leads, a series editor, an accessibility writer), with screenshots captured live in JupyterLab via Playwright at the site's panel-capture sizes. Reviewed in two rounds by six reviewer agents (technical fact-check, Jekyll conventions, prose/style, screenshot/caption accuracy, tone/positioning, coverage/proportionality).

Round 1 found and round 2 confirmed fixed:

  • Image paths used the pre-rename /notebook-intelligence/assets/... prefix that now 404s; corrected to /assets/....
  • Two screenshots leaked a local username path and personal skill names; both cropped out.
  • Post 2 carried 11 inline (#NNN) PR references; removed to match the blog's zero-PR-citation convention.

Every technical claim (env var / traitlet / policy names, defaults, behaviors, and 5.0.0-vs-5.0.1 version attributions) was verified against the main CHANGELOG and code.

Testing

Static-site content. Verified: all post_url targets resolve to files in this PR; all six image embeds resolve to committed files; front-matter/permalink/date consistency; zero em dashes; blog-index inclusion logic (archived != true).

Risks / follow-ups

  • Screenshots reflect a single developer machine: the launcher shows only the Claude Code tile (other tiles are PATH-gated), which the prose calls out explicitly.
  • The four older 2025 posts still use the stale /notebook-intelligence/assets/... image prefix and likely have broken images on the live site; out of scope here, worth a separate cleanup.

pjdoland added 2 commits May 29, 2026 09:08
Adds a feature deep-dive series to the blog, backdated across 5/26-5/28,
covering the 5.0.0 and 5.0.1 surface as narrative posts (distinct from
the existing v5.0.0 release-notes post):

- 2026-05-26 Managing Claude's toolbox: Skills, MCP, and Plugins
  (the three new top-level Settings tabs and the admin-policy triad)
- 2026-05-27 An agent-aware chat sidebar
  (progress feedback, refresh-on-disk, @-mention attach, terminal
   drag-drop, new-tab links, first-run tour)
- 2026-05-28 Coding-agent launchers, Codex, and a hardened platform
  (launcher tiles, Codex via /responses, dynamic Copilot models,
   accessibility pass, security hardening, fastmcp to mcp)

Each post follows the deep-dive conventions (post layout, /blog/<slug>/
permalink, description, sibling cross-links, a series-nav footer) and
embeds raw UI screenshots under assets/images/whats-new-5x/ via
root-relative /assets paths to match the post-rename site. The
Skills and External-changes captures are cropped to keep a local
username path and personal skill names out of the public images.
The org rename to plmbr moved the site to baseurl: / and url:
https://plmbr.dev, but several places kept pre-rename forms that
produce broken output:

- `{{site.baseurl}}{% post_url %}` renders `//blog/...` under baseurl:
  /, which a browser reads as the host `blog`. Dropped the redundant
  `{{site.baseurl}}` prefix so cross-links render `/blog/...`. Fixes the
  new 5.x series posts and the four archived 2025 posts.
- `_sass/_typography.scss` `@font-face` src pointed at
  `/notebook-intelligence/assets/fonts/*.woff2`, which 404s site-wide,
  silently falling back to system fonts on every page. Now `/assets/...`.
  (The head.html preload was already correct via relative_url.)
- The four archived 2025 posts embedded images at
  `/notebook-intelligence/assets/images/...`, broken since the rename.
  Now `/assets/images/...`.

Verified with a local Jekyll build + serve: fonts, all post images, and
all cross-links return 200 and resolve to single-slash root-relative
paths.
@pjdoland
Copy link
Copy Markdown
Collaborator Author

Folded in a round of post-rename link/asset cleanup after a local Jekyll preview surfaced broken links and missing fonts (these were pre-existing, from the org rename to baseurl: / and plmbr.dev, not introduced by the new posts):

  • Cross-links rendered //blog/... because {{site.baseurl}}{% post_url %} under baseurl: / produces / + /blog/slug/ = //blog/slug/, which a browser reads as host blog. Dropped the redundant {{site.baseurl}} prefix in the three new posts and the four archived 2025 posts so links render /blog/....
  • Site-wide font 404: _sass/_typography.scss @font-face pointed at /notebook-intelligence/assets/fonts/*.woff2, 404ing on every page and falling back to system fonts. Now /assets/.... (The head.html preload was already correct.)
  • Archived 2025 posts' images used the stale /notebook-intelligence/assets/images/... prefix; now /assets/images/....

Verified locally with jekyll build/serve: fonts, every post image, and all cross-links return 200 and resolve to single-slash root-relative paths. The title still reflects the primary change (the new 3-part series); this cleanup rides along since it is the same baseurl-rename class of fix.

@pjdoland pjdoland added the documentation Improvements or additions to documentation label May 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant