​

Learning Path

​

Step 1: Understand The Runtime Split

• README.md
• docs/RENDER_RUNTIME_CONTRACT.md

• understand backend runtime vs iframe runtime

​

Step 2: Learn Safe Plugin Authoring

• docs/SAFE_PLUGIN_AUTHORING.md
• docs/EXTENSION_POINTS.md

• learn what is public contract vs anti-pattern

​

Step 3: Start From Fixtures

• examples/fixtures/minimal-plugin.fixture.ts
• examples/fixtures/error-handling-plugin.fixture.ts
• examples/fixtures/storage-plugin.fixture.ts

• get a production-friendly starting point instead of copying learning examples blindly

​

Step 4: Learn Capability And Privileged Actions

• docs/HOST_PRIVILEGED_ACTIONS_CONTRACT.md
• docs/API_STABILITY.md

• understand what the host owns
• understand what capabilities are required

​

Step 5: Use Numbered Examples Intentionally

• examples/05-advanced-dom-plugin.ts
• examples/08-privileged-actions-plugin.ts
• examples/09-operator-plugin.ts
• examples/13-service-content-hub-plugin.ts

​

Step 6: For Provider Integrations

• host owns transport and session state
• plugin owns provider-specific parsing and UX

• docs/SHAREPOINT_PROVIDER_HOST_CONTRACT.md

​

Practical Outcome

• mixing runtimes
• misusing render()
• skipping renderHTML(...)
• using stores too early
• treating examples as stronger than the actual public contract