Skip to content

docs: describe the 3.0.0 design in the internal docs and set version 3.0.0 - #72

Merged
Blind-Striker merged 2 commits into
aot/public-docs-3.0.0from
aot/internal-docs-3.0.0
Oct 23, 2026
Merged

Blind-Striker merged 2 commits into
aot/public-docs-3.0.0from
aot/internal-docs-3.0.0

Conversation

@Blind-Striker

@Blind-Striker Blind-Striker commented Oct 23, 2026 •

Copy link
Copy Markdown
Member

Stack (review bottom-up, merge as one stack): #62 base, #66 the #63 fix, #67 Native AOT test lane, #68 static-factory generic path, #70 slim generator, #71 public docs, #72 internal docs and 3.0.0, #73 reflection-free test, #74 package consumer in CI, #75 convention clean-up, #76 service catalog refresh.

Goal of the stack: 3.0.0, where existing consumers upgrade without code changes, both packages support Native AOT on net10.0/net11.0, and the libraries use no runtime reflection for types the compiler can see (a JIT-only fallback covers the rest).

This PR

The internal docs now describe the shipped design:

  • docs/architecture/*: the static-factory generic path, the slim generator, the JIT-only guarded fallback, the net10.0/net11.0 targets and the Native AOT test lane. The TryAddAwsService<TService>(lifetime, useServiceUrl) ignores useServiceUrl #63 caveat is removed.
  • ADR 0004 records the decision and the alternatives that mattered. ADR 0001 matches the current support policy.
  • Quality gates cover the AOT lane and Windows-only net472 tests. The maintenance playbook records that the Core internals Extensions uses keep their signatures within a major version.
  • AGENTS.md, changelog additions, and a sandbox comment fix.
  • Directory.Build.props: both packages set to 3.0.0. The platform document's owner table points at the shared framework properties.

@Blind-Striker
Blind-Striker added this pull request to stack #69 October 23, 2026 13:33
@github-actions

Copy link
Copy Markdown

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

…3.0.0

- platform-and-packaging, client-runtime and extensions-and-composition now
  describe the static-factory generic path, the slim generator for the Type
  APIs, the JIT-only guarded reflection fallback, the net10.0/net11.0 target
  set and the Native AOT test lane; the #63 caveat is gone
- ADR 0004 records the chosen design and the alternatives that mattered;
  ADR 0001 no longer calls v2 the supported line
- quality gates cover the Native AOT lane and Windows-only net472 tests;
  the maintenance playbook records the Extensions/Core internal-member rule
- AGENTS.md points at where Native AOT support is documented and qualified
- Directory.Build.props: both packages 3.0.0
- CHANGELOG [Unreleased]: Native AOT test lane, Windows-only net472 tests,
  IsAotCompatible; generator wording matches the implementation
- Sandbox comment: the default LocalStack host is localhost.localstack.cloud
@Blind-Striker
Blind-Striker force-pushed the aot/internal-docs-3.0.0 branch from 1064c77 to 346c319 Compare October 23, 2026 21:13
@Blind-Striker
Blind-Striker marked this pull request as ready for review October 23, 2026 21:55
@Blind-Striker
Blind-Striker merged commit 49573c2 into master Oct 23, 2026
19 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant