Skip to content

Close documentation structure gaps against Arc for .NET - #87

Merged
woksin merged 8 commits into
mainfrom
docs/structure-parity
Sep 26, 2026
Merged

woksin merged 8 commits into
mainfrom
docs/structure-parity

Conversation

@woksin

@woksin woksin commented Sep 26, 2026

Copy link
Copy Markdown
Contributor

Changed

  • The OpenAPI documentation is split into concept, enum, command, query and model-bound topic pages in the Arc for .NET order. The schemas page keeps the worked example and its existing anchors, and the command and query pages describe the validation-only operation, 401 responses and declared-result paging.
  • New identity contracts reference: IdentityDetailsProvider registration, the /.cratis/me response and its status codes, and the principal-first trust model compared with the cookie-first identity in Arc for .NET.
  • New end-to-end tenancy guide, from tenant selection and membership checks to tenant-scoped MongoDB, Drizzle and Chronicle reads, including how long a tenant decision lasts.
  • New SQL page on schema and column mapping, codecs, host-owned drizzle-kit migrations, change ordering and database credentials.
  • The contributing guide maps the Arc for .NET test applications to the TypeScript samples, adapter suites and contract checks.
  • Paging and sorting argument names are documented as reserved query-string names.

Refs #78

Mirror the Arc for .NET open-api navigation with concepts, commands,
queries, enums, and model-bound pages. Keep schemas.md as the worked
example and anchor hub, and note that FromRequest is C#-only.

Refs #78
Document the IdentityDetailsProvider contract and registrations, the
/.cratis/me response, and the principal-first trust model compared with
Arc for .NET, citing the source files.

Refs #78
Follow one request from tenant selection through membership checks to
tenant-scoped MongoDB, Drizzle, and Chronicle reads, and document how
long a tenant decision lasts for each kind of execution.

Refs #78
Explain how read-model fields map to Drizzle columns and codecs, how a
host generates and applies drizzle-kit migrations for every tenant, how
to order schema and code changes, and which database credentials to use.

Refs #78
Add a crosswalk from TestApps/ArcCore and TestApps/AspNetCore to the
Tasks and Library samples, the host adapter suites, and the contract
checks, and name the .NET behaviors with no counterpart by design.

Refs #78
@woksin woksin added the no-release No consumer-facing artifact changes label Sep 26, 2026
@woksin woksin self-assigned this Sep 26, 2026
@woksin
woksin merged commit 9689f14 into main Sep 26, 2026
3 checks passed
@cratis-direct
cratis-direct Bot deleted the docs/structure-parity branch September 26, 2026 13:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

no-release No consumer-facing artifact changes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant