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.

docs.layout

Shared layout shell for documentation pages.

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

    Shared layout shell for documentation pages.

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

    Shared layout shell for documentation pages.

    Goal

    Provide consistent navigation, layout, and docs UI scaffolding.

    Context

    Used by web docs surfaces to render DocBlock-based content.

    Source Definition

    import { definePresentation } from '../../presentations';
    import {
    	DOCS_DOMAIN,
    	DOCS_OWNERS,
    	DOCS_STABILITY,
    	DOCS_TAGS,
    } from '../constants';
    import { docId } from '../registry';
    
    export const DocsLayoutPresentation = definePresentation({
    	meta: {
    		key: 'docs.layout',
    		title: 'Docs Layout',
    		version: '1.0.0',
    		description: 'Shared layout shell for documentation pages.',
    		goal: 'Provide consistent navigation, layout, and docs UI scaffolding.',
    		context: 'Used by web docs surfaces to render DocBlock-based content.',
    		domain: DOCS_DOMAIN,
    		owners: DOCS_OWNERS,
    		tags: [...DOCS_TAGS, 'layout'],
    		stability: DOCS_STABILITY,
    		docId: [docId('docs.tech.docs-system')],
    	},
    	capability: {
    		key: 'docs.system',
    		version: '1.0.0',
    	},
    	source: {
    		type: 'component',
    		framework: 'react',
    		componentKey: 'docsLayout',
    	},
    	targets: ['react'],
    });