Skip to content

docs(26.05): split Charles deployment reconcile updates#2314

Closed
kheiss-uwzoo wants to merge 3 commits into
NVIDIA:26.05from
kheiss-uwzoo:docs/pr2311-charles-deployment-reconcile
Closed

docs(26.05): split Charles deployment reconcile updates#2314
kheiss-uwzoo wants to merge 3 commits into
NVIDIA:26.05from
kheiss-uwzoo:docs/pr2311-charles-deployment-reconcile

Conversation

@kheiss-uwzoo

Copy link
Copy Markdown
Collaborator

Summary

Review context

This is part of the owner-based split of #2311 so previous contributors can review their own 26.05 reconcile changes.

Test plan

  • Pre-commit hooks passed on commit.
  • Scope checked against upstream/26.05: one commit, intended docs files only.

Port Charles-owned deployment, FAQ, getting-started, and overview reconcile changes from PR 2311 onto 26.05. Includes branch-pinned Helm links for 26.05 release docs.
@kheiss-uwzoo kheiss-uwzoo requested review from a team as code owners July 7, 2026 23:03
@kheiss-uwzoo kheiss-uwzoo requested review from jioffe502 and removed request for a team July 7, 2026 23:03
@greptile-apps

greptile-apps Bot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

This PR updates the 26.05 extraction docs handoffs and guidance. The main changes are:

  • Reworked deployment option links for Helm, air-gapped, and audio/video paths.
  • Updated FAQ guidance for caption scope, Nemotron Parse, and API keys.
  • Adjusted getting-started and overview links for notebooks and starter content.

Confidence Score: 4/5

This is close, but the release Helm handoff should be fixed before merging.

  • Most changed docs are straightforward release-link and guidance updates.
  • One edited getting-started link still sends 26.05 users to the development Helm README.
  • That can lead users to copy chart guidance that does not match the release they are installing.

docs/docs/extraction/getting-started-about.md

Important Files Changed

Filename Overview
docs/docs/extraction/deployment-options.md Updates deployment guidance and several Helm-related links for the 26.05 docs.
docs/docs/extraction/faq.md Clarifies captioning, Nemotron Parse, and environment variable guidance.
docs/docs/extraction/getting-started-about.md Updates the getting-started deployment flow, but one Helm link still points at the development branch.
docs/docs/extraction/overview.md Updates related topic links for deployment, notebooks, and starter content.
Prompt To Fix All With AI
Fix the following 1 code review issue. Work through them one at a time, proposing concise fixes.

---

### Issue 1 of 1
docs/docs/extraction/getting-started-about.md:11
**Pin release Helm link**

This getting-started page is for the 26.05 release flow, but the supported Helm chart link still opens the `main` branch. A new Kubernetes user can follow this first-run path, copy chart values or upgrade guidance added after 26.05, and apply settings that do not match the 26.05 chart. Point this link at the 26.05 branch so the release docs hand off to release-matched Helm docs.

```suggestion
    - **Supported:** [Helm chart](https://github.com/NVIDIA/NeMo-Retriever/blob/26.05/nemo_retriever/helm/README.md) for Kubernetes cluster install and upgrade
```

Reviews (2): Last reviewed commit: "Update docs/docs/extraction/deployment-o..." | Re-trigger Greptile

Comment thread docs/docs/extraction/deployment-options.md Outdated
Comment thread docs/docs/extraction/deployment-options.md
Comment thread docs/docs/extraction/deployment-options.md Outdated
Comment thread docs/docs/extraction/getting-started-about.md
Comment on lines +51 to +52
- [Notebooks](starter-kits.md)
- [NVIDIA AI Blueprints catalog](https://build.nvidia.com/explore/discover) — solution cards, enterprise RAG blueprints, and end-to-end patterns (including [Enterprise RAG — multimodal PDF data extraction](https://build.nvidia.com/nvidia/multimodal-pdf-data-extraction-for-enterprise-rag)); for integration pathways, refer to [Starter kits](starter-kits.md).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Overview Links Target Missing Page

Both changed overview links now reference starter-kits.md, which does not exist in docs/docs/extraction/. This can break the strict docs build and sends overview readers to a missing page instead of the existing notebooks and integration guidance.

Suggested change
- [Notebooks](starter-kits.md)
- [NVIDIA AI Blueprints catalog](https://build.nvidia.com/explore/discover) — solution cards, enterprise RAG blueprints, and end-to-end patterns (including [Enterprise RAG — multimodal PDF data extraction](https://build.nvidia.com/nvidia/multimodal-pdf-data-extraction-for-enterprise-rag)); for integration pathways, refer to [Starter kits](starter-kits.md).
- [Notebooks](notebooks/index.md)
- [NVIDIA AI Blueprints catalog](https://build.nvidia.com/explore/discover) — solution cards, enterprise RAG blueprints, and end-to-end patterns (including [Enterprise RAG — multimodal PDF data extraction](https://build.nvidia.com/nvidia/multimodal-pdf-data-extraction-for-enterprise-rag)); for integration pathways, refer to [Integrations](integrations-langchain-llamaindex-haystack.md).
Prompt To Fix With AI
This is a comment left during a code review.
Path: docs/docs/extraction/overview.md
Line: 51-52

Comment:
**Overview Links Target Missing Page**

Both changed overview links now reference `starter-kits.md`, which does not exist in `docs/docs/extraction/`. This can break the strict docs build and sends overview readers to a missing page instead of the existing notebooks and integration guidance.

```suggestion
- [Notebooks](notebooks/index.md)
- [NVIDIA AI Blueprints catalog](https://build.nvidia.com/explore/discover) — solution cards, enterprise RAG blueprints, and end-to-end patterns (including [Enterprise RAG — multimodal PDF data extraction](https://build.nvidia.com/nvidia/multimodal-pdf-data-extraction-for-enterprise-rag)); for integration pathways, refer to [Integrations](integrations-langchain-llamaindex-haystack.md).
```

How can I resolve this? If you propose a fix, please make it concise.

kheiss-uwzoo and others added 2 commits July 7, 2026 16:07
Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>
Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>
- **Supported:** [Helm chart](https://github.com/NVIDIA/NeMo-Retriever/blob/main/nemo_retriever/helm/README.md) for Kubernetes, plus [NeMo Retriever Library install docs](https://docs.nvidia.com/nemo/retriever/latest/extraction/overview/) for the published charts
4. Explore [Jupyter Notebooks](notebooks/index.md) for end-to-end examples.
- [Deployment options](deployment-options.md) for library, hosted NIMs, and Kubernetes paths
- **Supported:** [Helm chart](https://github.com/NVIDIA/NeMo-Retriever/blob/main/nemo_retriever/helm/README.md) for Kubernetes cluster install and upgrade

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Pin release Helm link

This getting-started page is for the 26.05 release flow, but the supported Helm chart link still opens the main branch. A new Kubernetes user can follow this first-run path, copy chart values or upgrade guidance added after 26.05, and apply settings that do not match the 26.05 chart. Point this link at the 26.05 branch so the release docs hand off to release-matched Helm docs.

Suggested change
- **Supported:** [Helm chart](https://github.com/NVIDIA/NeMo-Retriever/blob/main/nemo_retriever/helm/README.md) for Kubernetes cluster install and upgrade
- **Supported:** [Helm chart](https://github.com/NVIDIA/NeMo-Retriever/blob/26.05/nemo_retriever/helm/README.md) for Kubernetes cluster install and upgrade
Prompt To Fix With AI
This is a comment left during a code review.
Path: docs/docs/extraction/getting-started-about.md
Line: 11

Comment:
**Pin release Helm link**

This getting-started page is for the 26.05 release flow, but the supported Helm chart link still opens the `main` branch. A new Kubernetes user can follow this first-run path, copy chart values or upgrade guidance added after 26.05, and apply settings that do not match the 26.05 chart. Point this link at the 26.05 branch so the release docs hand off to release-matched Helm docs.

```suggestion
    - **Supported:** [Helm chart](https://github.com/NVIDIA/NeMo-Retriever/blob/26.05/nemo_retriever/helm/README.md) for Kubernetes cluster install and upgrade
```

How can I resolve this? If you propose a fix, please make it concise.

@kheiss-uwzoo kheiss-uwzoo marked this pull request as draft July 7, 2026 23:15
@kheiss-uwzoo kheiss-uwzoo self-assigned this Jul 7, 2026
@kheiss-uwzoo kheiss-uwzoo added doc Improvements or additions to documentation 26.05 labels Jul 7, 2026
@kheiss-uwzoo

Copy link
Copy Markdown
Collaborator Author

Closing: no 26.5.0-valid delta after #2313; changes are main-only and introduce broken links.

Triage vs upstream/26.05 (post-#2313):

  • deployment-options.md — links to starter-kits.md and openshift.md (neither exists on 26.05); removes integrations-langchain-llamaindex-haystack.md (does exist on 26.05); stale-tag / anchor churn from main
  • getting-started-about.md — notebooks/index.md → starter-kits.md (broken on 26.05)
  • overview.md — same starter-kits.md retarget (broken)
  • faq.md — redundant with docs(26.05): extraction reconcile updates scoped to 26.5.0 behavior #2313 (already merged)

Recommendation: keep 26.05 deployment/getting-started/overview pages as shipped; do not port main IA here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

26.05 doc Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant