# Documentation index

Use this index to find the maintained document for a question instead of
copying status or policy into another file.

**Last reviewed: 2026-10-02.** The documentation set may have changed. The
[default-branch index](https://github.com/obiente/native/blob/main/docs/README.md)
is the source of truth for maintained public documents.

## Product direction and compatibility

- [Platform strategy](../PLATFORMS.md): shared and platform-specific ownership,
  plus a dated implementation snapshot.
- [Compatibility contract](../COMPATIBILITY.md): dated native implementation
  evidence and the target product-completeness rules.
- [Roadmap](../ROADMAP.md): planned work, order, and acceptance gates.

## Architecture contracts

- [Adapter architecture](../ADAPTER_ARCHITECTURE.md): transport, repositories,
  adapters, persistence, errors, mutations, and required tests.
- [Dynamic App Descriptor](../DYNAMIC_APP_DESCRIPTOR.md): discovered API facts
  and execution policy.
- [Native Schema](../NATIVE_SCHEMA.md): the trust boundary between discovery
  and native presentation.
- [Shared choice controls](shared-ui-controls.md): when to use the shared
  segmented control and choice field, and the behavior they guarantee.
- [ADR 0001: Android Office integration](architecture-decisions/0001-android-office-web-integration.md):
  why Android embeds only a selected document's Office session.

## Contributing, testing and security

- [Sign-in recovery and login diagnostics](login-diagnostics.md): browser approval,
  connection retries, server certificate trust, cancellation, and saving a
  diagnostics report before sign-in.
- [Contributing](../CONTRIBUTING.md): quick start, running the apps and tests,
  troubleshooting, test-account safety, pull requests, and authorship.
- [Nextcloud compatibility instance](../integration/nextcloud-demo/README.md):
  a disposable test server with synthetic data for authenticated testing.
- [Server companions](../server-companion/README.md): optional server apps
  that add narrow capabilities.
- [Repository maintenance guide](../AGENTS.md): code ownership, documentation,
  Compose, diagnostics, testing, and safe refactoring requirements for humans
  and agents.
- [AI policy](../AI_POLICY.md): allowed assistance and human responsibility.
- [Security policy](../SECURITY.md): private vulnerability reporting and the
  dated support statement.

## Release engineering

- [Prerelease policy](releases.md): versions, changelog fragments, tags, and
  protected release builds.
- [Changelog fragments](../changes/README.md): required metadata, validation,
  release preparation, and archive ownership.
- [Prerelease checklist](prerelease-checklist.md): release-blocking safety and
  packaging checks.
- [Windows MSI qualification](windows-release.md): unsigned-package disclosure,
  provenance, and acceptance criteria.
- [Linux package repositories](linux-package-repositories.md): signed APT and
  RPM repository snapshots.

## Website and maintained assets

- [Website contributor guide](../website/README.md): content, captures, builds,
  and deployment configuration.
- [Design assets](../design/README.md): canonical icon sources and asset
  ownership.
- [Marketing capture assets](../ui/src/desktopTest/resources/marketing/README.md):
  provenance for the synthetic organization avatar.

Time-sensitive documents state when they were last reviewed. Treat that date
as context, not a guarantee; follow the linked source of truth before making a
release, compatibility, installation, or security-support claim.