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

Pros:

Cons:

Option 2: Merge into Navigator on homepage

Pros:

Cons:

Option 3: /docs redirects to filtered homepage view

Pros:

Cons:

Decision needed

Related

Related Posts

  • Separating Docs from Posts: Routing Architecture
    How documentation pages are separated from blog posts using type-based routing, allowing docs to live at /docs/ while posts stay at /posts/.
  • Building the Navigator: A Route Search Tool
    A complete walkthrough of the Navigator feature - a popover search tool for quickly finding and navigating to any route in the application.