refactor/flat-content-structure - #666
Open
serafim-san wants to merge 3 commits into
Open
Conversation
serafim-san
force-pushed
the
refactor/flat-content-structure
branch
from
August 18, 2026 13:07
e63f707 to
5048c48
Compare
Remove the getting-started/guides/resources/ai-toolkit section level so content paths mirror public URLs 1:1. Pure file moves.
Drop getPublicSlug/paths.ts: with flat content folders doc.id is the public URL, so slug stripping and the collision guard are unnecessary by construction. Sidebar section membership and top-level order now come from ROOT_SECTIONS items arrays in src/config/navigation.ts.
Top-level sidebar order now comes from ROOT_SECTIONS items arrays; frontmatter order is only read for nested articles.
serafim-san
force-pushed
the
refactor/flat-content-structure
branch
from
August 26, 2026 00:01
5048c48 to
c32094c
Compare
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
1 participant
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.
Description
This refactoring has been hanging over me as tech debt since the academy migration. During the move I changed the content file structure (section folders + mapping to flat URLs), thinking it would make working with folders easier. Dima rightly pointed out back then that there's little to gain from it: academy URLs are flat and SEO-frozen, and a folder hierarchy is only justified when it's isomorphic to the URL space. Any "tree → URL" transformation is a permanent tax: the getPublicSlug bottleneck that every path went through.
What's done:
Checks: sitemap.xml is set-identical before/after, sidebar link sequence is unchanged