Skip to content

docs: crosslink Python API guide adjacent to python snippets#2246

Closed
kheiss-uwzoo wants to merge 1 commit into
NVIDIA:mainfrom
kheiss-uwzoo:docs/python-snippet-api-crosslinks
Closed

docs: crosslink Python API guide adjacent to python snippets#2246
kheiss-uwzoo wants to merge 1 commit into
NVIDIA:mainfrom
kheiss-uwzoo:docs/python-snippet-api-crosslinks

Conversation

@kheiss-uwzoo

Copy link
Copy Markdown
Collaborator

Summary

Apply reviewer guidance: every ```python fence on extraction doc pages should have a same-section crosslink to the Python API guide (per .cursor/rules/nrl-python-snippet-api-crosslinks.mdc).

Updated pages

  • embedding.md — one crosslink per example section (three ## sections)
  • audio-video.md — hosted Parakeet example (Helm section already had a link)
  • custom-metadata.mdRetriever.query filter example (pseudocode block unchanged)
  • nimclient.md — section-level crosslinks for ModelInterface, UDF, error-handling, and debugging sections

Already compliant (no changes): workflow-document-ingestion.md, faq.md, vdbs.md, custom-metadata.md (ingest snippet), audio-video.md (Helm snippet).

Test plan

  • Spot-check rendered pages: crosslink appears immediately above each runnable python fence
  • rg '```python' docs/docs/extraction -l vs pages with nemo-retriever-api-reference in same section

Add same-section links to nemo-retriever-api-reference.md on extraction
pages where python fences lacked an adjacent API guide crosslink.
@kheiss-uwzoo

Copy link
Copy Markdown
Collaborator Author

Superseded by combined draft PR #2245.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant