TODO: Decide on /docs routing strategy
By Jay Griffin · January 23, 2026
docs
🏷️ Tags:todoroutingnavigationux
Figure out whether to create dedicated /docs page or surface all docs on homepage via Navigator
TODO: Decide on /docs routing strategy
Problem
README links to /docs but it's currently a 404. Need to decide on approach.
Options
Option 1: Create dedicated /docs homepage
- New route at
src/app/docs/page.tsx - Shows all docs with filtering/sorting
- Separate from main homepage
- README link works immediately
Pros:
- Clear separation (posts vs docs)
- Dedicated space for documentation
- README accuracy restored
Cons:
- Another page to maintain
- Splitting content across multiple views
- Might duplicate Navigator functionality
Option 2: Merge into Navigator on homepage
- Surface all docs on main homepage
- Use Navigator filtering/tags
- Change README link to just
/or/postsor create redirect
Pros:
- Single unified view of all content
- Navigator already has filtering
- Less duplicate UI
Cons:
- Homepage might get crowded
- Docs mixed with posts/commits
- Need better filtering UX
Option 3: /docs redirects to filtered homepage view
/docsredirects to/?type=docor similar- URL-based filtering on homepage
- Navigator respects query params
Pros:
- Best of both - clean URL, unified UI
- No duplicate pages
- Extensible to other filters
Cons:
- Need to implement query param filtering
- More complex routing logic
Decision needed
- Which approach fits the "single powerful homepage" vision?
- Is Navigator search/filter good enough yet?
- Should content types have dedicated pages or unified view?
Related
- Search/filtering improvements (roadmap)
- Navigator UX enhancements
- Homepage design philosophy