ci: fix fern CLI after docs/ migration by adding fern/ symlink (#6219)

Signed-off-by: Dan Gil <dagil@nvidia.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Meenakshi Sharma <163925564+nvda-mesharma@users.noreply.github.com>

.github/workflows/fern-docs.yml

@@ -99,6 +99,11 @@ jobs:
       - name: Install Fern CLI
         run: npm install -g fern-api
 
+      # Fern CLI expects a fern/ directory; create symlink after docs/ migration
+      - name: Create fern directory symlink
+        working-directory: docs
+        run: ln -s . fern
+
       - name: Validate Fern configuration
         working-directory: docs
         run: fern check
@@ -123,6 +128,11 @@ jobs:
       - name: Install Fern CLI
         run: npm install -g fern-api
 
+      # Fern CLI expects a fern/ directory; create symlink after docs/ migration
+      - name: Create fern directory symlink
+        working-directory: docs
+        run: ln -s . fern
+
       - name: Check for broken links
         working-directory: docs
         run: fern docs broken-links
@@ -266,6 +276,12 @@ jobs:
         if: steps.changes.outputs.has_changes == 'true'
         run: npm install -g fern-api
 
+      # Fern CLI expects a fern/ directory; create symlink after docs/ migration
+      - name: Create fern directory symlink
+        if: steps.changes.outputs.has_changes == 'true'
+        working-directory: docs-checkout/docs
+        run: ln -s . fern
+
       - name: Publish Docs
         if: steps.changes.outputs.has_changes == 'true'
         env:
@@ -458,6 +474,11 @@ jobs:
       - name: Install Fern CLI
         run: npm install -g fern-api
 
+      # Fern CLI expects a fern/ directory; create symlink after docs/ migration
+      - name: Create fern directory symlink
+        working-directory: ./docs
+        run: ln -s . fern
+
       - name: Publish Docs
         env:
           FERN_TOKEN: ${{ secrets.FERN_TOKEN }}

deploy/helm/charts/crds/templates/nvidia.com_dynamographdeploymentrequests.yaml

@@ -427,7 +427,7 @@ spec:
                 profilingResults:
                   description: |-
                     ProfilingResults contains a reference to the ConfigMap holding profiling data.
-                    Format: "configmap/<name>"
+                    Format: "configmap/\<name\>"
                   type: string
                 state:
                   description: |-

deploy/operator/api/v1alpha1/dynamographdeploymentrequest_types.go

@@ -216,7 +216,7 @@ type DynamoGraphDeploymentRequestStatus struct {
 	Conditions []metav1.Condition `json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type"`
 
 	// ProfilingResults contains a reference to the ConfigMap holding profiling data.
-	// Format: "configmap/<name>"
+	// Format: "configmap/\<name\>"
 	// +kubebuilder:validation:Optional
 	ProfilingResults string `json:"profilingResults,omitempty"`
 

deploy/operator/config/crd/bases/nvidia.com_dynamographdeploymentrequests.yaml

@@ -427,7 +427,7 @@ spec:
                 profilingResults:
                   description: |-
                     ProfilingResults contains a reference to the ConfigMap holding profiling data.
-                    Format: "configmap/<name>"
+                    Format: "configmap/\<name\>"
                   type: string
                 state:
                   description: |-

deploy/operator/docs/header.md

-<!--
-SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
-SPDX-License-Identifier: Apache-2.0
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
--->
+---
+# SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+---
 
 > **⚠️ Important**: This documentation is automatically generated from source code.
 > Do not edit this file directly.

docs/pages/backends/vllm/vllm-omni.md

-<!--
-SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
-SPDX-License-Identifier: Apache-2.0
--->
+---
+# SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+---
 
 # [Experimental] Running Omni Models with vLLM
 

docs/pages/kubernetes/api-reference.md

@@ -36,7 +36,7 @@ Package v1alpha1 contains API Schema definitions for the nvidia.com v1alpha1 API
 
 
 Deprecated: This field is deprecated and ignored. Use DynamoGraphDeploymentScalingAdapter
-with HPA, KEDA, or Planner for autoscaling instead. See docs/kubernetes/autoscaling.md
+with HPA, KEDA, or Planner for autoscaling instead. See docs/pages/kubernetes/autoscaling.md
 for migration guidance. This field will be removed in a future API version.
 
 
@@ -335,7 +335,7 @@ _Appears in:_
 | `dynamoNamespace` _string_ | DynamoNamespace is deprecated and will be removed in a future version.<br />The DGD Kubernetes namespace and DynamoGraphDeployment name are used to construct the Dynamo namespace for each component |  | Optional: \{\} <br /> |
 | `globalDynamoNamespace` _boolean_ | GlobalDynamoNamespace indicates that the Component will be placed in the global Dynamo namespace |  |  |
 | `resources` _[Resources](#resources)_ | Resources requested and limits for this component, including CPU, memory,<br />GPUs/devices, and any runtime-specific resources. |  |  |
-| `autoscaling` _[Autoscaling](#autoscaling)_ | Deprecated: This field is deprecated and ignored. Use DynamoGraphDeploymentScalingAdapter<br />with HPA, KEDA, or Planner for autoscaling instead. See docs/kubernetes/autoscaling.md<br />for migration guidance. This field will be removed in a future API version. |  |  |
+| `autoscaling` _[Autoscaling](#autoscaling)_ | Deprecated: This field is deprecated and ignored. Use DynamoGraphDeploymentScalingAdapter<br />with HPA, KEDA, or Planner for autoscaling instead. See docs/pages/kubernetes/autoscaling.md<br />for migration guidance. This field will be removed in a future API version. |  |  |
 | `envs` _[EnvVar](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.28/#envvar-v1-core) array_ | Envs defines additional environment variables to inject into the component containers. |  |  |
 | `envFromSecret` _string_ | EnvFromSecret references a Secret whose key/value pairs will be exposed as<br />environment variables in the component containers. |  |  |
 | `volumeMounts` _[VolumeMount](#volumemount) array_ | VolumeMounts references PVCs defined at the top level for volumes to be mounted by the component. |  |  |
@@ -375,7 +375,7 @@ _Appears in:_
 | `dynamoNamespace` _string_ | DynamoNamespace is deprecated and will be removed in a future version.<br />The DGD Kubernetes namespace and DynamoGraphDeployment name are used to construct the Dynamo namespace for each component |  | Optional: \{\} <br /> |
 | `globalDynamoNamespace` _boolean_ | GlobalDynamoNamespace indicates that the Component will be placed in the global Dynamo namespace |  |  |
 | `resources` _[Resources](#resources)_ | Resources requested and limits for this component, including CPU, memory,<br />GPUs/devices, and any runtime-specific resources. |  |  |
-| `autoscaling` _[Autoscaling](#autoscaling)_ | Deprecated: This field is deprecated and ignored. Use DynamoGraphDeploymentScalingAdapter<br />with HPA, KEDA, or Planner for autoscaling instead. See docs/kubernetes/autoscaling.md<br />for migration guidance. This field will be removed in a future API version. |  |  |
+| `autoscaling` _[Autoscaling](#autoscaling)_ | Deprecated: This field is deprecated and ignored. Use DynamoGraphDeploymentScalingAdapter<br />with HPA, KEDA, or Planner for autoscaling instead. See docs/pages/kubernetes/autoscaling.md<br />for migration guidance. This field will be removed in a future API version. |  |  |
 | `envs` _[EnvVar](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.28/#envvar-v1-core) array_ | Envs defines additional environment variables to inject into the component containers. |  |  |
 | `envFromSecret` _string_ | EnvFromSecret references a Secret whose key/value pairs will be exposed as<br />environment variables in the component containers. |  |  |
 | `volumeMounts` _[VolumeMount](#volumemount) array_ | VolumeMounts references PVCs defined at the top level for volumes to be mounted by the component. |  |  |
@@ -486,7 +486,7 @@ _Appears in:_
 | `backend` _string_ | Backend is extracted from profilingConfig.config.engine.backend for display purposes.<br />This field is populated by the controller and shown in kubectl output. |  | Optional: \{\} <br /> |
 | `observedGeneration` _integer_ | ObservedGeneration reflects the generation of the most recently observed spec.<br />Used to detect spec changes and enforce immutability after profiling starts. |  |  |
 | `conditions` _[Condition](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.28/#condition-v1-meta) array_ | Conditions contains the latest observed conditions of the deployment request.<br />Standard condition types include: Validation, Profiling, SpecGenerated, DeploymentReady.<br />Conditions are merged by type on patch updates. |  |  |
-| `profilingResults` _string_ | ProfilingResults contains a reference to the ConfigMap holding profiling data.<br />Format: "configmap/`<name>`" |  | Optional: \{\} <br /> |
+| `profilingResults` _string_ | ProfilingResults contains a reference to the ConfigMap holding profiling data.<br />Format: "configmap/\<name\>" |  | Optional: \{\} <br /> |
 | `generatedDeployment` _[RawExtension](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.28/#rawextension-runtime-pkg)_ | GeneratedDeployment contains the full generated DynamoGraphDeployment specification<br />including metadata, based on profiling results. Users can extract this to create<br />a DGD manually, or it's used automatically when autoApply is true.<br />Stored as RawExtension to preserve all fields including metadata.<br />For mocker backends, this contains the mocker DGD spec. |  | EmbeddedResource: \{\} <br />Optional: \{\} <br /> |
 | `deployment` _[DeploymentStatus](#deploymentstatus)_ | Deployment tracks the auto-created DGD when AutoApply is true.<br />Contains name, namespace, state, and creation status of the managed DGD. |  | Optional: \{\} <br /> |