Search, Categories, and Suggested Posts#

The directory needs to feel simple from the outside and deterministic from the inside.

URL-driven filtering#

The directory uses query parameters:

• q for search
• category for filtering
• page for pagination

That keeps the state shareable and crawlable.

Ranking rules#

Search ranks title and description matches above category, tags, and body content. That helps obvious results rise to the top.

Suggested posts#

Suggested posts can come from three strategies:

1. related posts
2. recent posts
3. manual curation with automatic backfill

The example site defaults to related posts so the demo shows useful relevance out of the box.