OSS-first docs

These docs teach the open system first: contracts, generated surfaces, runtimes, governance, and incremental adoption. Studio shows up as the operating layer on top, not as the source of truth.

AI index

docs.reference.page

Reference page layout for contract documentation.

  • Type: presentation (presentation)
  • Version: 1.0.0
  • Tags: reference
  • File: packages/libs/contracts-spec/src/docs/presentations/docsReferencePage.presentation.ts
    • field.key.label
    docs.reference.page
    field.version.label
    1.0.0
    field.type.label
    presentation (presentation)
    field.title.label
    docs.reference.page
    field.description.label

    Reference page layout for contract documentation.

  • Type: presentation (presentation)
  • Version: 1.0.0
  • Tags: reference
  • File: packages/libs/contracts-spec/src/docs/presentations/docsReferencePage.presentation.ts
    • field.tags.label
    reference
    field.owners.label
    field.stability.label

    Reference page layout for contract documentation.

    Goal

    Render contract references with consistent metadata and formatting.

    Context

    Used by docs surfaces to present contract reference content and schemas.

    Source Definition

    import { definePresentation } from '../../presentations';
import {
	DOCS_DOMAIN,
	DOCS_OWNERS,
	DOCS_STABILITY,
	DOCS_TAGS,
} from '../constants';
import { docId } from '../registry';

export const DocsReferencePagePresentation = definePresentation({
	meta: {
		key: 'docs.reference.page',
		title: 'Docs Reference Page',
		version: '1.0.0',
		description: 'Reference page layout for contract documentation.',
		goal: 'Render contract references with consistent metadata and formatting.',
		context:
			'Used by docs surfaces to present contract reference content and schemas.',
		domain: DOCS_DOMAIN,
		owners: DOCS_OWNERS,
		tags: [...DOCS_TAGS, 'reference'],
		stability: DOCS_STABILITY,
		docId: [docId('docs.tech.docs-reference')],
	},
	capability: {
		key: 'docs.system',
		version: '1.0.0',
	},
	source: {
		type: 'component',
		framework: 'react',
		componentKey: 'docsReferencePage',
	},
	targets: ['react', 'markdown'],
});