Skip to content

Add weekly "New articles" log page and automation - #2957

Open
dbrian57 wants to merge 10 commits into
mainfrom
new-articles-log
Open

Add weekly "New articles" log page and automation#2957
dbrian57 wants to merge 10 commits into
mainfrom
new-articles-log

Conversation

@dbrian57

@dbrian57 dbrian57 commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

What this does

Adds a New articles page to the Release Notes tab that logs newly published articles week over week. The action only includes new English guides and support articles for W&B services.

dbrian57 and others added 2 commits July 23, 2026 14:09
Adds a "New articles" page under the Release Notes tab that lists newly
published English articles grouped by month, with prior years collapsed
into accordions. A weekly GitHub Action scans the past week's merged PRs
for added .mdx articles and opens a draft PR updating the page. Excludes
localized content, snippets, auto-generated reference docs, and synced
support articles. Seeded with articles from the past three weeks.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Support articles now appear in the new articles log (tag index pages
  under support/*/tags/ are still excluded as they are listings, not
  articles) so the support team can track new content.
- Each entry is prefixed with a bolded service label (Models, Weave,
  Support, and so on) derived from the article's top-level directory.
- When an article has no frontmatter description, the script falls back
  to the first sentence of the article body so entries are never blank.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@w-b-hivemind

w-b-hivemind Bot commented Jul 23, 2026

Copy link
Copy Markdown

HiveMind Sessions

2 sessions · 1h 40m · $42

Session Agent Duration Tokens Cost Lines
Fix Invalid Notebook GitHub Link
c3450bb3-fbbb-4318-bf26-c1cd4c9dfa7d
claude 6m 9.1K $1.61 +0 -0
Build New Articles Changelog for Docs Site
a80e8492-5ae7-4a3a-a775-67eeda0e3c1f
claude 1h 33m 124.4K $41 +851 -96
Total 1h 40m 133.5K $42 +851 -96
Screenshots

View all sessions in HiveMind →

Run claude --resume c3450bb3-fbbb-4318-bf26-c1cd4c9dfa7d to pickup where you left off.

@mintlify

mintlify Bot commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
wandb 🟢 Ready View Preview Jul 23, 2026, 6:41 PM

@github-actions

github-actions Bot commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

📚 Mintlify Preview Links

🔗 View Full Preview

✨ Added (1 total)

📄 Pages (1)

File Preview
release-notes/new-articles.mdx New Articles

📝 Changed (1 total)

⚙️ Other (1)
File
docs.json

🤖 Generated automatically when Mintlify deployment succeeds
📍 Deployment: f25a7ae at 2026-07-28 20:23:28 UTC

@github-actions

github-actions Bot commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

🔗 Link Checker Results

⚠️ Some issues were detected

Preview: https://wb-21fd5541-new-articles-log.mintlify.site

Full Github Actions output

@mintlify

mintlify Bot commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
wandb 🟡 Building Jul 23, 2026, 6:37 PM

Per team feedback: within each month, articles now sit under a heading
for their product (Models, Weave, Support, ...) and render as horizontal
arrow cards matching the support tag pages, instead of a flat bullet
list with bold prefixes.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@dbrian57
dbrian57 marked this pull request as ready for review July 23, 2026 20:09
@dbrian57
dbrian57 requested a review from a team as a code owner July 23, 2026 20:09
One-time curated backfill: 92 net-new articles from PRs merged since
2025-12-01. Every candidate was cross-checked against git history and
its PR's removed files to exclude content that was moved, split, or
regenerated rather than newly written -- notably the DocEngine support
migration (PR #2303), the Runs and Weave-tracking doc splits, nav
restructure stub pages, and slug renames.

Also maps aria/ to ARIA and hivemind to HiveMind, and labels root-level
product landing pages by filename instead of "General".

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@dbrian57

Copy link
Copy Markdown
Contributor Author

Backfill added: the page now covers every net-new article since December 2025 (92 articles across 8 months), so it launches with real history and the 2025 accordion is exercised in production from day one.

To keep moved/reorganized content out, each candidate was vetted against git history (git log --follow) and its PR's removed files. Excluded as not-actually-new:

The weekly action is unaffected — its URL-based dedupe treats the backfilled entries the same as its own.

The theme zeroes every prose h2 top margin (see typography.css), which
works when a paragraph precedes the heading but leaves the new-articles
month headings butted against the previous month's last Card. Scope a
3rem top margin to h2 ids shaped like "month-2xxx", which only the
new-articles log generates.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
PR #2647 was excluded from the backfill as a gray-zone restructure, but
it was a product launch with genuinely new content. Re-include its 13
pages: agent tracing guides, the agent integrations (Claude Agent SDK,
Claude Code, Codex, Google ADK, OpenAI Agents SDK, OpenClaw, Pi), and
two agents support articles. June 2026 now lists 43 articles.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@dbrian57

Copy link
Copy Markdown
Contributor Author

Correction to the backfill curation above: #2647 (Weave Agents launch) is now included — it was initially excluded as a restructure, but it's a product launch with genuinely new content. Its 13 pages (agent tracing guides, agent integrations, and two support articles) are now listed under June 2026, bringing the backfill to 105 articles.

Per team feedback, the page is now a rolling six-month window instead
of growing indefinitely: the script drops month sections six or more
calendar months old on every run (MAX_AGE_MONTHS, default 6). Trims the
backfill from 105 to 96 articles by expiring January 2026 and December
2025. The prior-year accordion logic remains for months that survive a
year boundary.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@dbrian57

Copy link
Copy Markdown
Contributor Author

Update per team feedback: the page is now a rolling six-month window. The script drops month sections six or more calendar months old on every weekly run (configurable via MAX_AGE_MONTHS), and the backfill was trimmed accordingly — January 2026 and December 2025 expired, leaving 96 articles (February–July 2026). The prior-year accordion logic stays in place for months that survive a year boundary (e.g., next January the page will still show August–December 2026 under a 2026 accordion).

@github-actions

github-actions Bot commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

Readability impact

Word-weighted Flesch-Kincaid grade change across 6 changed pages: +0.1 (harder).

Lower Flesch-Kincaid grade and higher reading ease both mean easier to read. This check is informational and never blocks a PR.

Human readability

Page FK grade before FK grade after FK Δ Reading ease Δ Direction
models/models_quickstart.mdx 9.2 9.2 +0.0 +0.0 unchanged
models/quickstart.mdx 7.9 9.2 +1.3 -9.6 harder
models/track.mdx 10.1 11.2 +1.1 -4.7 harder
models/track/config.mdx 10.3 10.4 +0.1 -0.9 harder
models/track/create-an-experiment.mdx 10.2 10.1 -0.1 +0.6 easier
models/track/project-page.mdx 8.2 8.2 +0.0 +0.1 unchanged
release-notes/new-articles.mdx 9.9 n/a

AI agent comprehension

Rated 0-3 (higher is easier for an agent to parse and act on).

Page Before After Δ
models/track/project-page.mdx
release-notes/new-articles.mdx
models/track/config.mdx
models/models_quickstart.mdx
models/track/create-an-experiment.mdx
models/quickstart.mdx
models/track.mdx

Curated-docs baseline median FK grade by type: conceptual 10.5, procedural 8.8, reference 9.4.

From workflow run 30395972316

With the rolling six-month window, collapsing prior years no longer
serves a purpose — at most one year boundary is ever visible. All
months now render as flat "## Month YYYY" headings; the parser and
renderer lose the accordion code paths. Also folds in wording tweaks
to the page intro.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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.

1 participant