docs: reorganize usage and migration documentation

.github/workflows/ci.yml

@@ -462,6 +462,7 @@ jobs:
     if: ${{ vars.SONAR_CI_ENABLED == 'true' && ((github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name == github.repository) || github.ref == 'refs/heads/main' || github.event_name == 'workflow_dispatch') }}
     permissions:
       contents: read
+      id-token: write
       issues: write
       pull-requests: write
 
@@ -538,6 +539,7 @@ jobs:
             pwsh -NoLogo -NoProfile -File './eng/run-sonar-tests.ps1'
 
       - name: Verify coverage report
+        id: verify_coverage
         shell: pwsh
         run: |
           $ErrorActionPreference = 'Stop'
@@ -569,6 +571,15 @@ jobs:
           SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
         run: dotnet sonarscanner end /d:sonar.token="${SONAR_TOKEN}"
 
+      - name: Upload coverage to Codecov
+        if: ${{ always() && steps.verify_coverage.outcome == 'success' && steps.sonar_end.outcome != 'cancelled' }}
+        uses: codecov/codecov-action@303a32d7a59b442fa8d48b6a1cc6825c09c847a5 # v7.1.1
+        with:
+          files: ./artifacts/coverage/sonar/coverage.xml
+          disable_search: true
+          fail_ci_if_error: true
+          use_oidc: true
+
       - name: Report Sonar quality gate conditions
         id: sonar_quality_gate
         if: ${{ always() && github.event_name == 'pull_request' }}

COMPATIBILITY.md

@@ -120,7 +120,7 @@ The fork preserves the main historical source-compatible API surface where possi
 
 The fork also adds public APIs for profiles, naming policies, generated materializers, persistence metadata, property converters, query helpers, immutable configuration, isolated runtime and DI.
 
-The fork-owned 3.0 line has published stable packages through 3.0.3. Public compatibility remains governed by SemVer and the package/API boundaries listed above.
+The maintained 3.x line follows Semantic Versioning. See the GitHub releases page for the current stable version. Public compatibility remains governed by SemVer and the package/API boundaries listed above.
 
 ## Unsupported Environments Or Claims