docs(operator): documentation rework (#1184)

- Deleted the "Advanced Configuration" section from the operator docs
- Cleaned up references to deprecated configuration patterns

Author: kimpenhaus

.github/workflows/docs-test.yml

@@ -25,6 +25,8 @@ jobs:
 
       - name: Install Dependencies
         working-directory: docs
+        env:
+          NPM_CONFIG_USERCONFIG: ${{ github.workspace }}/.npmrc
         run: npm ci
 
       - name: Build Docusaurus

.github/workflows/dotnet-pre-release.yml

@@ -41,6 +41,8 @@ jobs:
           cache-dependency-path: .release/package-lock.json
 
       - name: Setup Semantic Release
+        env:
+          NPM_CONFIG_USERCONFIG: ${{ github.workspace }}/.npmrc
         run: |
           # --ignore-scripts blocks all dependencies' lifecycle scripts; the one
           # patch we need is then applied explicitly via patch-package.

.github/workflows/dotnet-release.yml

@@ -40,6 +40,8 @@ jobs:
           cache-dependency-path: .release/package-lock.json
 
       - name: Setup Semantic Release
+        env:
+          NPM_CONFIG_USERCONFIG: ${{ github.workspace }}/.npmrc
         run: |
           # --ignore-scripts blocks all dependencies' lifecycle scripts; the one
           # patch we need is then applied explicitly via patch-package.

.github/workflows/gh-pages.yml

@@ -34,6 +34,8 @@ jobs:
 
       - name: Install Dependencies
         working-directory: docs
+        env:
+          NPM_CONFIG_USERCONFIG: ${{ github.workspace }}/.npmrc
         run: npm ci
 
       - name: Build Docusaurus

.npmrc

@@ -0,0 +1,2 @@
+# Repo-wide npm registry policy. Workflows pass this file explicitly.
+registry=https://registry.npmjs.org/

.release/.npmrc

@@ -0,0 +1,6 @@
+{
+  "position": 15,
+  "label": ".NET Aspire",
+  "collapsible": true,
+  "collapsed": true
+}

docs/docs/operator/advanced-configuration.mdx

@@ -1,7 +1,6 @@
 ---
 title: .NET Aspire
 description: Orchestrate and observe a KubeOps operator with .NET Aspire
-sidebar_position: 9.5
 ---
 
 # .NET Aspire Integration
@@ -10,8 +9,8 @@ sidebar_position: 9.5
 
 | Package | Side | Purpose |
 | --- | --- | --- |
-| [`KubeOps.Aspire.Hosting`](../packages/aspire-hosting) | AppHost | Adds `AddKubeOps<TProject>(...)` so the operator is orchestrated as a resource. |
-| [`KubeOps.Aspire`](../packages/aspire) | Operator | Adds `AddKubeOpsServiceDefaults()` for OpenTelemetry, service discovery, resilience and health checks. |
+| [`KubeOps.Aspire.Hosting`](../../packages/aspire-hosting) | AppHost | Adds `AddKubeOps<TProject>(...)` so the operator is orchestrated as a resource. |
+| [`KubeOps.Aspire`](../../packages/aspire) | Operator | Adds `AddKubeOpsServiceDefaults()` for OpenTelemetry, service discovery, resilience and health checks. |
 
 Together they give you a local dashboard with the operator's logs, traces and metrics, automatic service discovery to other resources, and a single entry point to run, publish, or deploy the whole stack.
 
@@ -48,7 +47,7 @@ await host.RunAsync();
 
 `AddKubeOpsServiceDefaults()` configures:
 
-- **OpenTelemetry** logging (with scopes and formatted messages), metrics (runtime + `HttpClient`) and tracing. It subscribes to the operator's `ActivitySource`, which KubeOps registers under the operator name (see [Logging, Tracing, and OpenTelemetry](./logging)).
+- **OpenTelemetry** logging (with scopes and formatted messages), metrics (runtime + `HttpClient`) and tracing. It subscribes to the operator's `ActivitySource`, which KubeOps registers under the operator name (see [Logging, Tracing, and OpenTelemetry](../observability/logging)).
 - **OTLP export** &mdash; enabled automatically when the `OTEL_EXPORTER_OTLP_ENDPOINT` environment variable is present. Aspire sets this for you, so traces and metrics show up in the dashboard with no extra code.
 - **Service discovery** &mdash; `HttpClient` instances resolve logical Aspire resource names (e.g. `https://apiservice`).
 - **HTTP resilience** &mdash; the standard resilience handler (retries, circuit breaker, timeouts) is applied to all `HttpClient` instances.
@@ -142,7 +141,7 @@ The operator process runs locally and authenticates through the selected Kuberne
 
 `KubeOps.Aspire` is usable from a plain console operator and therefore does **not** force an ASP.NET Core dependency. The default health checks are registered in the service collection, but exposing them over HTTP requires an HTTP server.
 
-If your operator already hosts webhooks via [`KubeOps.Operator.Web`](../packages/operator-web), map the endpoints on the `WebApplication`:
+If your operator already hosts webhooks via [`KubeOps.Operator.Web`](../../packages/operator-web), map the endpoints on the `WebApplication`:
 
 ```csharp
 app.MapHealthChecks("/health");
@@ -244,4 +243,4 @@ builder.AddKubeOps<Projects.AspireOperator>("operator")
     .PublishAsKubernetesOperator(aks, publish => publish.WithServiceAccount("operator"));
 ```
 
-For the deeper run/publish model, see [Aspire Kubernetes Operator Model](./aspire-kubernetes-model).
+For the deeper run/publish model, see [Aspire Kubernetes Operator Model](./kubernetes-operator-model).

docs/docs/operator/aspire/_category_.json

@@ -1,7 +1,7 @@
 ---
 title: Aspire Kubernetes Operator Model
 description: Run, publish, and deploy KubeOps operators with Aspire Kubernetes environments.
-sidebar_position: 12
+sidebar_position: 1
 ---
 
 # Aspire Kubernetes Operator Model