docs: Add comprehensive Apicurio Registry Operator documentation

[EricWittmann]

Summary

This PR adds comprehensive documentation for deploying and configuring Apicurio Registry using the Apicurio Registry Operator and the ApicurioRegistry3 custom resource.

New Documentation Files

• assembly-deploying-registry-operator.adoc - Complete deployment guide covering:

  • Operator overview and custom resource structure
  • Deployment with in-memory storage (development/testing)
  • Deployment with PostgreSQL storage (production)
  • Deployment with MySQL storage (production)
  • Deployment with KafkaSQL storage (production) with TLS and SASL authentication examples
  • Authentication and authorization configuration (OIDC, role-based access control, admin override)
  • Ingress and networking configuration
  • Feature flags (resource deletion, version mutability)
  • UI component configuration
  • Advanced configuration options (replicas, PodDisruptionBudget, custom PodTemplateSpec, etc.)

• assembly-operator-config-reference.adoc - Complete API reference including:

  • Custom resource structure
  • All configuration fields for app and ui components
  • Storage configuration (SQL and KafkaSQL with all options)
  • Authentication and authorization configuration
  • Ingress configuration
  • Field descriptions, types, defaults, and examples

Documentation Updates

• Updated nav.adoc to include the new documentation in:
  • Installation section (deployment guide)
  • Reference section (configuration reference)

Implementation Notes

The documentation follows:

• Existing AsciiDoc formatting conventions used throughout the project
• Strimzi operator documentation structure for consistency
• Real-world examples from the apicurio-testing repository
• Complete coverage of all CRD fields and options

Test plan

• Build and review generated documentation for formatting
• Verify all examples are syntactically correct
• Confirm navigation links work properly
• Cross-reference with actual CRD and model classes

[Copilot]

Pull request overview

This PR adds comprehensive documentation for deploying and configuring Apicurio Registry using the Apicurio Registry Operator and the ApicurioRegistry3 custom resource. The documentation follows existing AsciiDoc conventions and provides complete coverage for operators, developers, and administrators.

Key changes:

• New comprehensive operator deployment guide with examples for all storage types (in-memory, PostgreSQL, KafkaSQL)
• Complete API reference documentation for the ApicurioRegistry3 custom resource
• New high availability deployment guide covering architecture, scaling, monitoring, and backup/restore procedures

Reviewed changes

Copilot reviewed 12 out of 13 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
operator/model/src/main/java/io/apicurio/registry/operator/api/v1/spec/DataSourceSpec.java	Removes trailing whitespace from JsonPropertyDescription annotation
docs/modules/ROOT/partials/shared/attributes.adoc	Adds new operator-related attributes and removes deprecated v1 version attributes
docs/modules/ROOT/pages/index.adoc	Updates operator reference to use new {operator} attribute
docs/modules/ROOT/pages/getting-started/assembly-registry-high-availability.adoc	New comprehensive HA guide covering deployment, storage, monitoring, and DR procedures
docs/modules/ROOT/pages/getting-started/assembly-operator-config-reference.adoc	New complete API reference for ApicurioRegistry3 CR configuration
docs/modules/ROOT/pages/getting-started/assembly-deploying-registry-operator.adoc	New deployment guide with examples for all storage backends and configuration scenarios
docs/modules/ROOT/pages/getting-started/assembly-managing-registry-artifacts-ui.adoc	Updates terminology to use {operator} attribute consistently
docs/modules/ROOT/pages/getting-started/assembly-intro-to-the-registry.adoc	Updates operator references in distribution tables
docs/modules/ROOT/pages/getting-started/assembly-installing-registry-storage-openshift.adoc	Removes extra blank lines
docs/modules/ROOT/pages/getting-started/assembly-installing-registry-openshift.adoc	Updates operator installation references to use {operator} attribute
docs/modules/ROOT/pages/getting-started/assembly-configuring-the-registry.adoc	Updates operator terminology for consistency
docs/modules/ROOT/pages/getting-started/assembly-configuring-registry-security.adoc	Updates operator documentation link reference
docs/modules/ROOT/nav.adoc	Adds new documentation pages to navigation structure

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[pwright]

I think that's confusing

[jsenko]

Appended a couple of fixes found because of failing tests. It seemed easier than creating a separate PR.