Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Graph docs cleanup 202501 #654

Merged
merged 8 commits into from
Feb 4, 2025
Merged

Graph docs cleanup 202501 #654

merged 8 commits into from
Feb 4, 2025

Conversation

briangodsey
Copy link
Contributor

The knowledge graph tools within RAGStack have been superseded by another project. This PR makes changes to the graph-related docs, instructing users to visit the new project.

Also, we are deleting code and references to packages that are outdated, while leaving some useful explanatory content for now, so the pages don't disappear entirely and may be discoverable in search.

Because we have blogs and other external content that links directly to these pages, we want all incoming links to the former graph RAG pages to lead to the one remaining graph RAG page.

@briangodsey briangodsey requested a review from mendonk February 4, 2025 00:04
@plpesvc-ds
Copy link

Build failure! ❌

[00:06:50.429] ERROR (asciidoctor): target of xref not found: knowledge-graph:knowledge-graph.adoc file: docs/modules/ROOT/nav.adoc source: https://github.com/datastax/ragstack-ai.git (branch: graph-docs-cleanup-202501 | start path: docs) [00:06:50.433] ERROR (asciidoctor): target of xref not found: knowledge-graph:knowledge-store.adoc file: docs/modules/ROOT/nav.adoc source: https://github.com/datastax/ragstack-ai.git (branch: graph-docs-cleanup-202501 | start path: docs) > tailwindcss > tailwindcss build -c ${npm_config_tailwind_config_path} -i ${npm_config_css_path} -o ${npm_config_css_path} --minify Browserslist: caniuse-lite is outdated. Please run: npx update-browserslist-db@latest Why you should do it regularly: https://github.com/browserslist/update-db#readme Rebuilding... Done in 2664ms.

@plpesvc-ds
Copy link

Build failure! ❌

[14:13:18.685] ERROR (asciidoctor): target of xref not found: knowledge-graph:knowledge-graph.adoc file: docs/modules/ROOT/nav.adoc source: https://github.com/datastax/ragstack-ai.git (branch: graph-docs-cleanup-202501 | start path: docs) [14:13:18.690] ERROR (asciidoctor): target of xref not found: knowledge-graph:knowledge-store.adoc file: docs/modules/ROOT/nav.adoc source: https://github.com/datastax/ragstack-ai.git (branch: graph-docs-cleanup-202501 | start path: docs) > tailwindcss > tailwindcss build -c ${npm_config_tailwind_config_path} -i ${npm_config_css_path} -o ${npm_config_css_path} --minify Browserslist: caniuse-lite is outdated. Please run: npx update-browserslist-db@latest Why you should do it regularly: https://github.com/browserslist/update-db#readme Rebuilding... Done in 2635ms.

@mendonk
Copy link
Contributor

mendonk commented Feb 4, 2025

Follow on redirects PR: https://github.com/riptano/docs-infra/pull/112

@plpesvc-ds
Copy link

plpesvc-ds commented Feb 4, 2025

Build successful! ✅
Deploying draft.
Deploy successful! View draft

@plpesvc-ds
Copy link

plpesvc-ds commented Feb 4, 2025

Build successful! ✅
Deploying draft.
Deploy successful! View draft

@plpesvc-ds
Copy link

plpesvc-ds commented Feb 4, 2025

Build successful! ✅
Deploying draft.
Deploy successful! View draft

Copy link
Contributor

@mendonk mendonk left a comment

Choose a reason for hiding this comment

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

Pushed some small changes and added page aliases for redirecting the outdated pages. You may merge when you're ready.

@briangodsey briangodsey merged commit 0b1ed84 into main Feb 4, 2025
22 of 23 checks passed
@briangodsey briangodsey deleted the graph-docs-cleanup-202501 branch February 4, 2025 18:59
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.

3 participants