Documentation and release notes proof of concept

Documentation and release notes proof of concept

We’re exploring two new ways to make BuiltCold knowledge easier to find and maintain.

A dedicated documentation site

The documentation proof of concept combines public Buy Clean guidance with an administrator section protected by BuiltCold authentication and permissions. Public content can be shared broadly, while operational details remain available only to the people who need them.

Release notes with context

This blog gives product updates a durable, searchable home. Rather than publishing a list of ticket titles, each release note can explain what changed, who benefits, and whether project teams need to do anything differently.

What this first version proves

• Nextra applications can live alongside the BuiltCold frontend in the existing Turborepo.
• Documentation routes can use Clerk authentication and server-side authorization.
• Release notes can be authored as reviewed MDX files in the same repository as the product.
• The sites can deploy independently to docs.builtcold.com and blog.builtcold.com.

This is a publishing proof of concept, not a production launch. Content structure, authoring workflow, search, analytics, and final visual design will be refined with the team.