Adding new docs link(s) to readme. Adding landing page for API refs#2228
Adding new docs link(s) to readme. Adding landing page for API refs#2228cjnolet wants to merge 9 commits into
Conversation
Co-authored-by: Divye Gala <divyegala@gmail.com>
📝 WalkthroughSummary by CodeRabbit
WalkthroughThe PR updates API reference documentation by replacing RAPIDS-hosted API links in README.md with direct references to the NVIDIA cuVS documentation site, and introduces a new Fern-based API reference landing page that aggregates language-specific NVIDIA API documentation links with corresponding navigation configuration. ChangesAPI Reference Documentation Updates
Estimated code review effort🎯 1 (Trivial) | ⏱️ ~5 minutes Possibly related PRs
Suggested labels
Suggested reviewers
🚥 Pre-merge checks | ✅ 4 | ❌ 1❌ Failed checks (1 inconclusive)
✅ Passed checks (4 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
Comment |
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@README.md`:
- Around line 15-19: Search the repo for legacy docs.rapids.ai/cuvs links and
replace them with the canonical docs.nvidia.com/cuvs endpoints (or confirm and
annotate intentional redirects) — specifically update the references found in
python/cuvs/pyproject.toml, python/libcuvs/pyproject.toml, fern/pages/index.md
and any cuVS notebooks to use https://docs.nvidia.com/cuvs (or the appropriate
subpaths such as /api/cuvs, /installation, /getting-started); if a legacy link
must remain, add a brief comment/NOTE in that file explaining it intentionally
points to the legacy host. Ensure URL scheme, host and path match the README
style and run a repo-wide grep for docs.rapids.ai to catch remaining instances.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Path: .coderabbit.yaml
Review profile: CHILL
Plan: Enterprise
Run ID: f6b0b997-27e9-4016-bcc9-325be5dde02b
📒 Files selected for processing (3)
README.mdfern/docs.ymlfern/pages/api_reference.md
| - [Documentation](https://docs.nvidia.com/cuvs): Library documentation. | ||
| - [Build and Install Guide](https://docs.nvidia.com/cuvs/installation): Instructions for installing and building cuVS. | ||
| - [Getting Started Guide](https://docs.nvidia.com/cuvs/getting-started): Guide to getting started with cuVS. | ||
| - [Code Examples](https://github.com/rapidsai/cuvs/tree/HEAD/examples): Self-contained Code Examples. | ||
| - [API Reference Documentation](https://docs.rapids.ai/api/cuvs/nightly/api_docs): API Documentation. | ||
| - [API Reference Documentation](https://docs.nvidia.com/cuvs/api_reference): API Documentation. |
There was a problem hiding this comment.
🧩 Analysis chain
🏁 Script executed:
#!/bin/bash
# Description: Find remaining references to old RAPIDS docs URLs
# Search for old docs.rapids.ai URLs across the codebase
rg -n 'docs\.rapids\.ai/api/cuvs' -g '!README.md'Repository: rapidsai/cuvs
Length of output: 1629
🏁 Script executed:
#!/bin/bash
# Description: Find remaining references to any legacy RAPIDS docs domain
rg -n 'docs\.rapids\.ai' -g '!README.md'Repository: rapidsai/cuvs
Length of output: 3874
Align remaining cuVS documentation URLs beyond README
README now links to docs.nvidia.com/cuvs, but the repo still contains legacy docs.rapids.ai/api/cuvs/... pointers (e.g., python/cuvs/pyproject.toml, python/libcuvs/pyproject.toml, fern/pages/index.md, and cuVS-related notebooks). This can lead to inconsistent doc navigation depending on entry point—either update these to docs.nvidia.com/cuvs or confirm the legacy links are intentionally kept/redirect.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@README.md` around lines 15 - 19, Search the repo for legacy
docs.rapids.ai/cuvs links and replace them with the canonical
docs.nvidia.com/cuvs endpoints (or confirm and annotate intentional redirects) —
specifically update the references found in python/cuvs/pyproject.toml,
python/libcuvs/pyproject.toml, fern/pages/index.md and any cuVS notebooks to use
https://docs.nvidia.com/cuvs (or the appropriate subpaths such as /api/cuvs,
/installation, /getting-started); if a legacy link must remain, add a brief
comment/NOTE in that file explaining it intentionally points to the legacy host.
Ensure URL scheme, host and path match the README style and run a repo-wide grep
for docs.rapids.ai to catch remaining instances.
|
/ok to test 89fdd26 |
No description provided.