Skip to content

docs: split changelog into yearly pages for SEO/AEO#29

Open
rachaelrenk wants to merge 2 commits intomainfrom
changelog/split-by-year
Open

docs: split changelog into yearly pages for SEO/AEO#29
rachaelrenk wants to merge 2 commits intomainfrom
changelog/split-by-year

Conversation

@rachaelrenk
Copy link
Copy Markdown
Contributor

Summary

Split the single 4,002-line changelog/index.mdx into 6 yearly pages (2021–2026) for better SEO/AEO, faster page loads, and to resolve the hast-util-to-text stack overflow that excluded the changelog from llms-full.txt.

Addresses this Notion item.

Changes

New files

  • src/content/docs/changelog/2026.mdx through 2021.mdx — yearly changelog pages, each with year-specific frontmatter and all entries for that year

src/content/docs/changelog/index.mdx

  • Replaced ~4,000 lines of entries with a thin landing page linking to each yearly page

src/sidebar.ts

  • Expanded changelog sidebar to list all 6 yearly pages
  • Topic-level link now points to /changelog/2026/ (latest year)

astro.config.mjs

  • Added changelog/** as a custom set in the llms.txt plugin config
  • Removed the comment that excluded changelog from llms.txt

.agents/skills/update-changelog/SKILL.md

  • Updated to target the current year's file (e.g. changelog/2026.mdx) instead of index.mdx
  • Added year-rollover logic for when a new year begins

.agents/skills/afdocs-audit/references/known-exceptions.md

  • Updated page-size-markdown exception to reflect the split (no longer allowlisted)

Notes

  • The llms-full.txt build error (hast-util-to-text stack overflow) is pre-existing on main — caused by open-source-licenses.mdx (~25k lines), not this change
  • No new redirects needed since these are new URLs; existing /changelog/ redirects still work via the landing page

Oz conversation · Plan

Co-Authored-By: Oz oz-agent@warp.dev

Split the single 4,002-line changelog/index.mdx into 6 yearly pages
(2021-2026). The original index.mdx becomes a thin landing page linking
to each year.

- Create yearly pages: changelog/2021.mdx through changelog/2026.mdx
- Update sidebar config to list all yearly pages
- Add changelog to llms.txt custom sets (no longer excluded)
- Update update-changelog skill for yearly file targeting
- Update AFDocs known-exceptions for resolved page-size warning

Co-Authored-By: Oz <oz-agent@warp.dev>
@cla-bot cla-bot Bot added the cla-signed label May 6, 2026
@vercel
Copy link
Copy Markdown

vercel Bot commented May 6, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment May 6, 2026 8:29pm

Request Review

Reduce Warp repetition and include auto-update info.

Co-Authored-By: Oz <oz-agent@warp.dev>
---

Submit bugs and feature requests on our [GitHub board!](https://github.com/warpdotdev/Warp/issues/new/choose)

### 2026.04.27 (v0.2026.04.27.15.32)
* [**2026**](/changelog/2026/) — January 2026 to present
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure we need the months here, feels a bit unnecessary

@@ -1,4002 +1,16 @@
---
title: Changelog
description: >-
Warp auto-updates whenever a new release comes out. We try to ship an update
every week usually on Thursday!
Warp ships weekly updates, typically on Thursdays. The app auto-updates
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hmh, does it auto update? I'm pretty sure you have to OK it manually (which is how it should be). What are we trying to say here?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants