Skip to content

docs: Clean unused assets, reorganize the directory structure to match the nav for easier 3rd party contribution#10025

Merged
aimurphy merged 20 commits into
mainfrom
lfoss-1977
Sep 30, 2025
Merged

docs: Clean unused assets, reorganize the directory structure to match the nav for easier 3rd party contribution#10025
aimurphy merged 20 commits into
mainfrom
lfoss-1977

Conversation

@aimurphy
Copy link
Copy Markdown
Collaborator

@aimurphy aimurphy commented Sep 29, 2025

Closes LFOSS-1977

Reorganize the /docs subdirectories to match the new navigation layout.
Remove unused assets (images, files, videos) from /docs.
Move all images and files to the /static subdirectory
Combine Google, NVIDA, Notion pages into single pages.

Summary by CodeRabbit

  • Documentation
    • Reorganized docs with new structure (Get Started, Tutorials, Flows, Deployment, Develop, Support) and Bundles pages (Apify, AssemblyAI, Cleanlab, Composio, Docling, Google, Notion, NVIDIA, Vertex AI).
    • Added Notion bundle guide; expanded NVIDIA docs; improved Google BigQuery guidance.
    • Updated slugs, links, and asset paths; removed legacy Integrations pages; overhauled sidebar navigation.
    • Implemented comprehensive redirects to new bundle paths; refreshed related references in release notes.

@aimurphy aimurphy self-assigned this Sep 29, 2025
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Sep 29, 2025

Important

Review skipped

Auto incremental reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Walkthrough

Documentation reorganization: multiple “Integrations” pages removed or migrated to “Bundles.” Added/expanded bundle docs (Notion, NVIDIA, Google BigQuery guide), updated links, slugs, and asset paths. Updated site redirects and sidebar structure to align with the new docs layout. No runtime or public API changes.

Changes

Cohort / File(s) Summary of changes
Docs routing and structure config
docs/docusaurus.config.js, docs/sidebars.js, .cursor/rules/docs_development.mdc
Expanded redirects to new /bundles-* slugs; removed obsolete Nvidia redirect; reorganized sidebar to new sections (Flows, Agents, Develop, Deploy, Components); noted top-level docs restructuring.
Integrations → Bundles path and asset updates
docs/docs/Components/bundles-apify.mdx, .../bundles-assemblyai.mdx, .../bundles-cleanlab.mdx, .../bundles-composio.mdx, .../bundles-docling.mdx, docs/docs/Components/components-data.mdx, docs/docs/Support/release-notes.mdx, docs/docs/Components/components-bundles.mdx, docs/docs/Components/bundles-vertexai.mdx, docs/docs/Tutorials/agent.mdx
Slug/link updates from /integrations-* to /bundles-*; standardized image/file paths to root-level /img and /files; removed one image reference; fixed a tutorial file link path.
Google bundle content expansion
docs/docs/Components/bundles-google.mdx
Expanded BigQuery documentation with setup, credentials, and sample query; updated cross-links to bundle pages; refreshed Composio/Apify references.
New Notion bundle doc
docs/docs/Components/bundles-notion.mdx
Added comprehensive Notion setup and flow guides (Meeting Notes Agent, Conversational Agent), run and troubleshooting sections; uses Icon component.
NVIDIA bundle expansion
docs/docs/Components/bundles-nvidia.mdx
Major expansion: added WSL2 NIM guide; enriched Retriever Extraction (nv‑ingest) and System‑Assist content with prerequisites, steps, and examples; imported partials.
Removal of legacy Integrations pages
docs/docs/Integrations/Google/integrations-google-big-query.mdx, docs/docs/Integrations/Notion/integrations-notion.mdx, .../Notion/notion-agent-conversational.mdx, .../Notion/notion-agent-meeting-notes.mdx, docs/docs/Integrations/Nvidia/integrations-nvidia-g-assist.mdx, .../Nvidia/integrations-nvidia-ingest.mdx, .../Nvidia/integrations-nvidia-nim-wsl2.mdx
Deleted legacy integration documents superseded by bundle pages (Google BigQuery, Notion guides and flows, NVIDIA G‑Assist, nv‑ingest, NIM on WSL2).

Sequence Diagram(s)

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

Suggested labels

documentation, size:XXL, lgtm

Suggested reviewers

  • mendonk
  • jordanrfrazier
  • KimberlyFields

Pre-merge checks and finishing touches

✅ Passed checks (7 passed)
Check name Status Explanation
Title Check ✅ Passed The pull request title "docs: Clean unused assets, reorganize the directory structure to match the nav for easier 3rd party contribution" accurately describes the main changes in the changeset. The changes primarily involve reorganizing documentation directories (moving files from Integrations to Components/bundles paths, updating sidebars.js to reflect new navigation structure), updating redirect configurations, and removing unused documentation files. The title correctly captures both the asset cleanup aspect (removal of unused docs) and the directory reorganization to align with the navigation structure, which directly supports the stated goal of easier third-party contribution.
Docstring Coverage ✅ Passed No functions found in the changes. Docstring coverage check skipped.
Test Coverage For New Implementations ✅ Passed This PR consists entirely of documentation reorganization and does not include any new code implementations, components, or functional changes that would require test coverage. All changes are within the docs/ directory and involve restructuring documentation files (moving/renaming MDX files), updating internal links and redirects (in docusaurus.config.js and sidebars.js), removing outdated documentation pages, and moving static assets (images, videos, JSON files). The only non-documentation file changed is .cursor/rules/docs_development.mdc, which is a documentation development guideline file that was updated to reflect the new directory structure (changing references from integrations/, administration/, and blog/ to agents/, deployment/, develop/, support/, etc.). Since no new features, components, bug fixes, or functional code changes are present in this PR, test coverage requirements do not apply.
Test Quality And Coverage ✅ Passed This pull request is exclusively a documentation reorganization effort that involves moving, renaming, and restructuring documentation files (.mdx), updating configuration files (docusaurus.config.js, sidebars.js), relocating static assets (images, videos, JSON files), and removing deprecated documentation pages. The git diff shows 151 files changed with operations that are purely renames (R100), deletions (D), modifications to paths and links (M), and additions of consolidated documentation (A). There is no implementation code whatsoever—no Python files, no TypeScript/JavaScript application code, no API endpoints, no business logic, and no functional changes to the Langflow application itself. The only .js files modified are Docusaurus configuration files that define redirects and sidebar navigation structure for the documentation site.
Test File Naming And Structure ✅ Passed This pull request contains only documentation and configuration file changes related to reorganizing the docs subdirectories to match a new navigation layout. The changed files include MDX documentation files (.mdx), JavaScript configuration files (docusaurus.config.js, sidebars.js), and a cursor rules file (.mdc). None of the files in this PR are test files following the patterns specified in the check (test_*.py for backend tests or .test.ts/.test.tsx for frontend tests). Since there are no test files to evaluate, the test file naming and structure check is not applicable to this pull request.
Excessive Mock Usage Warning ✅ Passed This pull request is a documentation reorganization effort that moves, renames, and deletes documentation files while updating internal links and asset paths. After reviewing all modified files in the diff, no test files were changed—the PR exclusively touches documentation files (.mdx), configuration files (docusaurus.config.js, sidebars.js), static assets (images, videos, JSON files), and documentation development rules (.mdc). Since no test files contain changes and the check specifically targets excessive mock usage in test files, there is no mock usage to assess in this pull request.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share
🧪 Early access (Sonnet 4.5): enabled

We are currently testing the Sonnet 4.5 model, which is expected to improve code review quality. However, this model may lead to increased noise levels in the review comments. Please disable the early access features if the noise level causes any inconvenience.

Note:

  • Public repositories are always opted into early access features.
  • You can enable or disable early access features from the CodeRabbit UI or by updating the CodeRabbit configuration file.

Comment @coderabbitai help to get the list of available commands and usage tips.

@aimurphy aimurphy changed the title Lfoss 1977 docs: Clean unused assets, reorganize the directory structure to match the nav for easier 3rd party contribution Sep 29, 2025
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Sep 29, 2025
@github-actions

This comment has been minimized.

@github-actions github-actions Bot added documentation Improvements or additions to documentation and removed documentation Improvements or additions to documentation labels Sep 29, 2025
@aimurphy aimurphy requested a review from mendonk September 29, 2025 19:13
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 4

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (3)
docs/docs/Components/bundles-vertexai.mdx (1)

1-4: Add description field to frontmatter.

Per coding guidelines, all documentation Markdown and MDX files must begin with a frontmatter block including at least title and description fields. This file is missing the description field.

Apply this diff to add the description:

 ---
 title: Vertex AI
 slug: /bundles-vertexai
+description: Learn how to use Google Vertex AI components in Langflow for text generation and embeddings with authentication setup guide.
 ---
.cursor/rules/docs_development.mdc (1)

46-68: Critical: Documentation structure uses incorrect directory naming convention.

The guidelines document specifies lowercase-hyphenated directory names (agents/, get-started/, tutorials/, etc.), but the actual implementation uses PascalCase directory names (Agents/, Get-Started/, Tutorials/, etc.). This is confirmed by:

  • Filesystem: All directories under docs/docs/ use PascalCase
  • sidebars.js: All document IDs reference PascalCase paths (e.g., Get-Started/about-langflow, Agents/agents, Flows/concepts-overview)

Required action: Update lines 46-58 to reflect the actual PascalCase directory structure used in the codebase.

docs/docusaurus.config.js (1)

299-357: Critical: Redirect targets are missing the /Components/ prefix.

All bundle redirect targets are incorrect and will result in 404 errors. Based on the codebase structure:

  • Bundle files are located at docs/docs/Components/bundles-*.mdx
  • Sidebar configuration references them as "Components/bundles-*"
  • Docusaurus serves docs at root (routeBasePath: "/")
  • Actual URLs: /Components/bundles-google, /Components/bundles-apify, etc.
  • Current redirects target: /bundles-google, /bundles-apify, etc. (missing /Components/)

Required fixes (lines 299-357):

Update all redirect targets to include the /Components/ prefix:

  • /bundles-google/Components/bundles-google
  • /bundles-apify/Components/bundles-apify
  • /bundles-assemblyai/Components/bundles-assemblyai
  • /bundles-cleanlab/Components/bundles-cleanlab
  • /bundles-composio/Components/bundles-composio
  • /bundles-docling/Components/bundles-docling
  • /bundles-notion/Components/bundles-notion
  • /bundles-nvidia/Components/bundles-nvidia
📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 20051c7 and 4d3e9ad.

⛔ Files ignored due to path filters (96)
  • docs/docs/Integrations/505849097.png is excluded by !**/*.png
  • docs/docs/Integrations/965098683.png is excluded by !**/*.png
  • docs/static/files/customer_orders.csv is excluded by !**/*.csv
  • docs/static/img/apify_agent_flow.png is excluded by !**/*.png
  • docs/static/img/apify_agent_flow_simple.png is excluded by !**/*.png
  • docs/static/img/apify_flow_wcc.png is excluded by !**/*.png
  • docs/static/img/assemblyai-components.png is excluded by !**/*.png
  • docs/static/img/cleanlab_remediator_example.png is excluded by !**/*.png
  • docs/static/img/cleanlab_remediator_example_fallback.png is excluded by !**/*.png
  • docs/static/img/component-combine-text.png is excluded by !**/*.png
  • docs/static/img/component-data-to-dataframe.png is excluded by !**/*.png
  • docs/static/img/component-embedding-models.png is excluded by !**/*.png
  • docs/static/img/component-local-db.png is excluded by !**/*.png
  • docs/static/img/component-message-history-message-store.png is excluded by !**/*.png
  • docs/static/img/component-run-flow.png is excluded by !**/*.png
  • docs/static/img/component-save-to-file.png is excluded by !**/*.png
  • docs/static/img/component-webhook-in-basic-prompting.png is excluded by !**/*.png
  • docs/static/img/composio-create-flow.png is excluded by !**/*.png
  • docs/static/img/configure-vertex-ai-credentials-in-langflow.gif is excluded by !**/*.gif
  • docs/static/img/connect-handles.png is excluded by !**/*.png
  • docs/static/img/eval_rag.png is excluded by !**/*.png
  • docs/static/img/eval_response.png is excluded by !**/*.png
  • docs/static/img/eval_summary_rag.png is excluded by !**/*.png
  • docs/static/img/google/create-a-google-cloud-project.gif is excluded by !**/*.gif
  • docs/static/img/google/create-oauth-client-id.gif is excluded by !**/*.gif
  • docs/static/img/integrations-bigquery.png is excluded by !**/*.png
  • docs/static/img/integrations-docling-split-text.png is excluded by !**/*.png
  • docs/static/img/langflow-astradb-component.png is excluded by !**/*.png
  • docs/static/img/langflow-logo-black.svg is excluded by !**/*.svg
  • docs/static/img/langflow-logo-white.svg is excluded by !**/*.svg
  • docs/static/img/lf-docs-mini.svg is excluded by !**/*.svg
  • docs/static/img/logo.svg is excluded by !**/*.svg
  • docs/static/img/mcp-server-api-key.png is excluded by !**/*.png
  • docs/static/img/notion/AddContentToPage_flow_example.png is excluded by !**/*.png
  • docs/static/img/notion/AddContentToPage_flow_example_dark.png is excluded by !**/*.png
  • docs/static/img/notion/NotionDatabaseProperties_flow_example.png is excluded by !**/*.png
  • docs/static/img/notion/NotionDatabaseProperties_flow_example_dark.png is excluded by !**/*.png
  • docs/static/img/notion/NotionListPages_flow_example.png is excluded by !**/*.png
  • docs/static/img/notion/NotionListPages_flow_example_dark.png is excluded by !**/*.png
  • docs/static/img/notion/NotionPageContent_flow_example.png is excluded by !**/*.png
  • docs/static/img/notion/NotionPageContent_flow_example_dark.png is excluded by !**/*.png
  • docs/static/img/notion/NotionPageCreator_flow_example.png is excluded by !**/*.png
  • docs/static/img/notion/NotionPageCreator_flow_example_dark.png is excluded by !**/*.png
  • docs/static/img/notion/NotionPageUpdate_flow_example.png is excluded by !**/*.png
  • docs/static/img/notion/NotionPageUpdate_flow_example_dark.png is excluded by !**/*.png
  • docs/static/img/notion/NotionSearch_flow_example.png is excluded by !**/*.png
  • docs/static/img/notion/NotionSearch_flow_example_dark.png is excluded by !**/*.png
  • docs/static/img/notion/NotionUserList_flow_example.png is excluded by !**/*.png
  • docs/static/img/notion/NotionUserList_flow_example_dark.png is excluded by !**/*.png
  • docs/static/img/notion/notion_bundle.jpg is excluded by !**/*.jpg
  • docs/static/img/notion/notion_components_bundle.png is excluded by !**/*.png
  • docs/static/img/notion/notion_components_bundle_dark.png is excluded by !**/*.png
  • docs/static/img/notion_conversational_agent_tools.png is excluded by !**/*.png
  • docs/static/img/notion_meeting_agent_part_1.png is excluded by !**/*.png
  • docs/static/img/notion_meeting_agent_part_2.png is excluded by !**/*.png
  • docs/static/img/nvidia-component-ingest-astra.png is excluded by !**/*.png
  • docs/static/img/open-logs-pane.png is excluded by !**/*.png
  • docs/static/img/openai-model-component.png is excluded by !**/*.png
  • docs/static/img/quickstart-add-document-ingestion.png is excluded by !**/*.png
  • docs/static/img/quickstart-basic-prompt-no-connections.png is excluded by !**/*.png
  • docs/static/img/settings-messages.png is excluded by !**/*.png
  • docs/static/img/starter-flow-basic-prompting.png is excluded by !**/*.png
  • docs/static/img/starter-flow-blog-writer.png is excluded by !**/*.png
  • docs/static/img/starter-flow-document-qa.png is excluded by !**/*.png
  • docs/static/img/starter-flow-financial-report-parser.png is excluded by !**/*.png
  • docs/static/img/starter-flow-memory-chatbot.png is excluded by !**/*.png
  • docs/static/img/starter-flow-sequential-agent.png is excluded by !**/*.png
  • docs/static/img/starter-flow-simple-agent-repl.png is excluded by !**/*.png
  • docs/static/img/starter-flow-simple-agent.png is excluded by !**/*.png
  • docs/static/img/starter-flow-travel-agent.png is excluded by !**/*.png
  • docs/static/img/starter-flow-vector-rag.png is excluded by !**/*.png
  • docs/static/img/tool-calling-agent-add-tools.png is excluded by !**/*.png
  • docs/static/img/url-component.png is excluded by !**/*.png
  • docs/static/img/vector-store-agent-retrieval-tool.png is excluded by !**/*.png
  • docs/static/logos/cloud_deploy.svg is excluded by !**/*.svg
  • docs/static/logos/greencheck.svg is excluded by !**/*.svg
  • docs/static/logos/monitor-langflow.svg is excluded by !**/*.svg
  • docs/static/logos/playbutton.svg is excluded by !**/*.svg
  • docs/static/notion_imgs/1911112500.png is excluded by !**/*.png
  • docs/static/notion_imgs/2091252224.png is excluded by !**/*.png
  • docs/static/videos/chat_memory.mp4 is excluded by !**/*.mp4
  • docs/static/videos/combine_text.mp4 is excluded by !**/*.mp4
  • docs/static/videos/create_record.mp4 is excluded by !**/*.mp4
  • docs/static/videos/langflow_api.mp4 is excluded by !**/*.mp4
  • docs/static/videos/langflow_build.mp4 is excluded by !**/*.mp4
  • docs/static/videos/langflow_collection.mp4 is excluded by !**/*.mp4
  • docs/static/videos/langflow_collection_example.mp4 is excluded by !**/*.mp4
  • docs/static/videos/langflow_fork.mp4 is excluded by !**/*.mp4
  • docs/static/videos/langflow_global_variables.mp4 is excluded by !**/*.mp4
  • docs/static/videos/langflow_parameters.mp4 is excluded by !**/*.mp4
  • docs/static/videos/langflow_playground.mp4 is excluded by !**/*.mp4
  • docs/static/videos/langflow_widget.mp4 is excluded by !**/*.mp4
  • docs/static/videos/pass.mp4 is excluded by !**/*.mp4
  • docs/static/videos/store_message.mp4 is excluded by !**/*.mp4
  • docs/static/videos/sub_flow.mp4 is excluded by !**/*.mp4
  • docs/static/videos/text_operator.mp4 is excluded by !**/*.mp4
📒 Files selected for processing (23)
  • .cursor/rules/docs_development.mdc (1 hunks)
  • docs/docs/Components/bundles-apify.mdx (2 hunks)
  • docs/docs/Components/bundles-assemblyai.mdx (3 hunks)
  • docs/docs/Components/bundles-cleanlab.mdx (2 hunks)
  • docs/docs/Components/bundles-composio.mdx (2 hunks)
  • docs/docs/Components/bundles-docling.mdx (2 hunks)
  • docs/docs/Components/bundles-google.mdx (5 hunks)
  • docs/docs/Components/bundles-notion.mdx (1 hunks)
  • docs/docs/Components/bundles-nvidia.mdx (3 hunks)
  • docs/docs/Components/bundles-vertexai.mdx (1 hunks)
  • docs/docs/Components/components-bundles.mdx (0 hunks)
  • docs/docs/Components/components-data.mdx (3 hunks)
  • docs/docs/Integrations/Google/integrations-google-big-query.mdx (0 hunks)
  • docs/docs/Integrations/Notion/integrations-notion.mdx (0 hunks)
  • docs/docs/Integrations/Notion/notion-agent-conversational.mdx (0 hunks)
  • docs/docs/Integrations/Notion/notion-agent-meeting-notes.mdx (0 hunks)
  • docs/docs/Integrations/Nvidia/integrations-nvidia-g-assist.mdx (0 hunks)
  • docs/docs/Integrations/Nvidia/integrations-nvidia-ingest.mdx (0 hunks)
  • docs/docs/Integrations/Nvidia/integrations-nvidia-nim-wsl2.mdx (0 hunks)
  • docs/docs/Support/release-notes.mdx (3 hunks)
  • docs/docs/Tutorials/agent.mdx (1 hunks)
  • docs/docusaurus.config.js (3 hunks)
  • docs/sidebars.js (11 hunks)
💤 Files with no reviewable changes (8)
  • docs/docs/Integrations/Google/integrations-google-big-query.mdx
  • docs/docs/Integrations/Notion/notion-agent-conversational.mdx
  • docs/docs/Integrations/Nvidia/integrations-nvidia-ingest.mdx
  • docs/docs/Integrations/Notion/notion-agent-meeting-notes.mdx
  • docs/docs/Integrations/Notion/integrations-notion.mdx
  • docs/docs/Integrations/Nvidia/integrations-nvidia-nim-wsl2.mdx
  • docs/docs/Integrations/Nvidia/integrations-nvidia-g-assist.mdx
  • docs/docs/Components/components-bundles.mdx
🧰 Additional context used
📓 Path-based instructions (3)
docs/docs/**/*.{md,mdx}

📄 CodeRabbit inference engine (.cursor/rules/docs_development.mdc)

docs/docs/**/*.{md,mdx}: All documentation content must be written in Markdown or MDX files located under docs/docs/, following the prescribed directory structure for guides, reference, how-to, concepts, and API documentation.
All documentation Markdown and MDX files must begin with a frontmatter block including at least title and description fields.
Use admonitions (:::tip, :::warning, :::danger) in Markdown/MDX files to highlight important information, warnings, or critical issues.
All images referenced in documentation must include descriptive alt text for accessibility.
All code examples included in documentation must be tested and verified to work as shown.
Internal links in documentation must be functional and not broken.
Content must follow the style guide: professional but approachable tone, second person voice, present tense, short paragraphs, sentence case headers, inline code with backticks, bold for UI elements, italic for emphasis, and parallel structure in lists.
Use consistent terminology: always capitalize Langflow, Component, Flow, and uppercase API and JSON.

Files:

  • docs/docs/Tutorials/agent.mdx
  • docs/docs/Components/bundles-docling.mdx
  • docs/docs/Components/bundles-notion.mdx
  • docs/docs/Components/bundles-vertexai.mdx
  • docs/docs/Components/bundles-apify.mdx
  • docs/docs/Components/components-data.mdx
  • docs/docs/Components/bundles-google.mdx
  • docs/docs/Support/release-notes.mdx
  • docs/docs/Components/bundles-cleanlab.mdx
  • docs/docs/Components/bundles-assemblyai.mdx
  • docs/docs/Components/bundles-composio.mdx
  • docs/docs/Components/bundles-nvidia.mdx
docs/docusaurus.config.js

📄 CodeRabbit inference engine (.cursor/rules/docs_development.mdc)

Site configuration such as title, tagline, URL, and navbar items must be managed in docs/docusaurus.config.js.

Files:

  • docs/docusaurus.config.js
docs/sidebars.js

📄 CodeRabbit inference engine (.cursor/rules/docs_development.mdc)

Sidebar navigation must be updated in docs/sidebars.js to reflect new or reorganized documentation content.

Files:

  • docs/sidebars.js
🧠 Learnings (5)
📚 Learning: 2025-09-07T05:44:46.715Z
Learnt from: TensorNull
PR: langflow-ai/langflow#9735
File: docs/docs/Components/bundles-cometapi.mdx:9-9
Timestamp: 2025-09-07T05:44:46.715Z
Learning: In Langflow bundle documentation files (docs/docs/Components/bundles-*.mdx), the standard link pattern for referencing the main Bundles page is [Bundles](/components-bundle-components), not /components-bundles. This pattern is used consistently across all 37+ bundle documentation files.

Applied to files:

  • docs/docs/Components/bundles-docling.mdx
  • docs/docs/Components/bundles-apify.mdx
  • docs/docs/Components/components-data.mdx
  • docs/docs/Components/bundles-cleanlab.mdx
  • docs/docs/Components/bundles-assemblyai.mdx
  • docs/docs/Components/bundles-composio.mdx
📚 Learning: 2025-07-18T18:26:42.027Z
Learnt from: CR
PR: langflow-ai/langflow#0
File: .cursor/rules/docs_development.mdc:0-0
Timestamp: 2025-07-18T18:26:42.027Z
Learning: Applies to docs/docs/**/*.{md,mdx} : Internal links in documentation must be functional and not broken.

Applied to files:

  • docs/docs/Components/components-data.mdx
📚 Learning: 2025-06-23T12:46:29.953Z
Learnt from: CR
PR: langflow-ai/langflow#0
File: .cursor/rules/docs_development.mdc:0-0
Timestamp: 2025-06-23T12:46:29.953Z
Learning: All terminology such as 'Langflow', 'Component', 'Flow', 'API', and 'JSON' must be capitalized or uppercased as specified in the terminology section.

Applied to files:

  • docs/docs/Components/bundles-assemblyai.mdx
📚 Learning: 2025-07-18T18:26:42.027Z
Learnt from: CR
PR: langflow-ai/langflow#0
File: .cursor/rules/docs_development.mdc:0-0
Timestamp: 2025-07-18T18:26:42.027Z
Learning: Applies to docs/sidebars.js : Sidebar navigation must be updated in docs/sidebars.js to reflect new or reorganized documentation content.

Applied to files:

  • docs/sidebars.js
📚 Learning: 2025-07-18T18:26:42.027Z
Learnt from: CR
PR: langflow-ai/langflow#0
File: .cursor/rules/docs_development.mdc:0-0
Timestamp: 2025-07-18T18:26:42.027Z
Learning: Applies to docs/docs/**/*.{md,mdx} : Use consistent terminology: always capitalize Langflow, Component, Flow, and uppercase API and JSON.

Applied to files:

  • docs/sidebars.js
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (2)
  • GitHub Check: Test Docs Build / Test Docs Build
  • GitHub Check: build-and-deploy
🔇 Additional comments (51)
docs/docs/Tutorials/agent.mdx (1)

33-33: Verified: File path is correct.

The file exists at the new location (docs/static/files/customer_orders.csv). The simplified path /files/customer_orders.csv is valid and will not result in a broken link.

docs/docs/Components/bundles-composio.mdx (3)

3-3: LGTM: Slug migration aligns with documentation reorganization.

The slug change from /integrations-composio to /bundles-composio correctly reflects the documentation restructuring from integrations to bundles terminology.


74-74: LGTM: Image path standardized to root-relative format.

The image path update to /img/composio-create-flow.png follows the root-relative pattern used across the documentation reorganization.


3-3: LGTM!

The slug update from /integrations-composio to /bundles-composio correctly aligns with the documentation reorganization described in the PR objectives.

docs/docs/Components/bundles-vertexai.mdx (2)

105-105: LGTM: Image path simplified and standardized.

The image path has been updated to remove the /google/ subdirectory, aligning with the standardized root-relative path structure used throughout the documentation reorganization.


105-105: LGTM!

The image path update standardizes the asset location by moving it from a subdirectory to the root /img directory, consistent with the documentation reorganization. The alt text is descriptive and meets accessibility requirements.

docs/docs/Components/bundles-apify.mdx (3)

3-3: LGTM: Slug migration aligns with bundle reorganization.

The slug change to /bundles-apify correctly reflects the transition from integrations to bundles taxonomy.


34-46: LGTM: All image paths standardized to root-relative format.

All three image references have been correctly updated to use root-relative paths (/img/apify_flow_wcc.png, /img/apify_agent_flow_simple.png, /img/apify_agent_flow.png), consistent with the documentation reorganization pattern.


3-3: LGTM!

The slug update to /bundles-apify and the standardization of image paths to root-relative format (e.g., /img/apify_flow_wcc.png) correctly align with the documentation reorganization. All images include descriptive alt text as required.

Also applies to: 34-34, 38-38, 46-46

docs/docs/Components/bundles-assemblyai.mdx (4)

3-3: LGTM: Slug migration follows bundle structure.

The slug update to /bundles-assemblyai correctly aligns with the documentation reorganization from integrations to bundles.


27-27: LGTM: Image path standardized.

The image path has been correctly updated to the root-relative format /img/assemblyai-components.png.


128-128: LGTM: File download link uses root-relative path.

The AssemblyAI flow JSON file reference has been correctly updated to /files/AssemblyAI_Flow.json, consistent with the root-relative path pattern.


3-3: LGTM!

The slug update to /bundles-assemblyai and the standardization of asset paths to root-relative format (/img/assemblyai-components.png and /files/AssemblyAI_Flow.json) correctly align with the documentation reorganization. All references include appropriate alt text or link descriptions.

Also applies to: 27-27, 128-128

docs/docs/Components/bundles-nvidia.mdx (11)

7-7: LGTM: PartialParams import added for documentation consistency.

The import of PartialParams from the MDX partial is appropriate for documenting hidden parameters, consistent with other bundle documentation files.


30-54: LGTM: Comprehensive NVIDIA NIM on WSL2 section added.

The new section provides clear, step-by-step instructions for setting up NVIDIA NIM on WSL2 with appropriate prerequisites, system requirements, and configuration details. The content follows the style guide with numbered steps and proper formatting.


83-194: LGTM: Detailed NVIDIA Retriever Extraction documentation added.

The expanded section provides comprehensive coverage of the NVIDIA nv-ingest integration, including:

  • Clear usage instructions with prerequisites
  • Installation commands for both source and PyPI installations
  • Complete parameter documentation
  • Output format specifications with document type details

The content is well-structured and follows documentation standards.


136-136: LGTM: Image reference uses root-relative path.

The image path /img/nvidia-component-ingest-astra.png follows the standardized root-relative format.


197-225: LGTM: NVIDIA System-Assist integration guide added.

The expanded section provides clear integration instructions for NVIDIA G-Assist, including system requirements, flow construction steps, and example usage. The content is well-organized and follows the documentation style guide.


2-2: LGTM!

The title "NVIDIA" uses proper all-caps formatting as specified in the coding guidelines for terminology consistency.


7-7: LGTM!

The PartialParams import is properly added and utilized on line 127 in the NVIDIA Retriever Extraction section.


106-117: LGTM!

The bash code blocks are properly formatted with clear placeholders for user-specific values. The commands demonstrate both installation methods (from source and from PyPI) appropriately.


83-193: Comprehensive expansion of NVIDIA Retriever Extraction documentation.

The expanded section includes detailed integration steps, prerequisites, parameter tables, and proper use of admonitions. The image includes descriptive alt text, terminology follows the coding guidelines, and all internal documentation links are verified to be functional.


30-54: Well-structured documentation section with verified external links.

The NVIDIA NIM on WSL2 section provides comprehensive setup instructions with proper formatting, terminology, and style. All external NVIDIA documentation links have been verified and are accessible.


197-225: Well-documented NVIDIA System-Assist integration guide.

The expanded section provides clear prerequisites, step-by-step instructions, and proper formatting. Terminology is consistent with coding guidelines, and UI elements are properly emphasized. Both the external GitHub link and internal documentation link have been verified as functional.

docs/docs/Components/bundles-google.mdx (3)

60-60: Image alt text is appropriately descriptive.

The alt text "BigQuery component connected to chat input and output" clearly describes the image content for accessibility.


66-88: Verify the SQL query example.

The SQL query example should be tested against an actual BigQuery dataset to ensure it works as shown. The example queries a table named oscar_winners in a dataset the_oscar_award within a project big-query-langflow-project.

As per coding guidelines, all code examples in documentation must be tested and verified to work as shown. Please confirm this query has been tested with the referenced dataset structure.


144-148: Internal links follow consistent patterns.

The links correctly reference bundle pages with the /bundles-* pattern, which aligns with the documentation reorganization.

Based on learnings.

docs/docs/Components/bundles-docling.mdx (2)

3-3: Slug update aligns with documentation reorganization.

The slug change from /integrations-docling to /bundles-docling correctly implements the PR objective to reorganize subdirectories to match the new navigation layout.


47-47: Image path and alt text are correct.

The absolute path /img/integrations-docling-split-text.png follows the documentation guidelines, and the alt text clearly describes the image content for accessibility.

.cursor/rules/docs_development.mdc (1)

46-53: Documentation structure reorganization is clearly documented.

The updated directory layout accurately reflects the PR's objective to reorganize the /docs subdirectories. The removal of integrations/ and addition of new top-level directories like agents/, get-started/, tutorials/, flows/, deployment/, develop/, and support/ aligns with the new navigation layout mentioned in the PR description.

docs/docs/Components/bundles-cleanlab.mdx (3)

3-3: Slug update aligns with documentation reorganization.

The slug change from /integrations-cleanlab to /bundles-cleanlab correctly implements the PR objective.


115-138: Image references use absolute paths with descriptive alt text.

All image paths correctly use absolute paths (/img/), and the alt text for each image is appropriately descriptive for accessibility compliance.

As per coding guidelines.


107-107: Download file verified and is valid JSON.

The file eval_and_remediate_cleanlab.json exists at docs/static/files/eval_and_remediate_cleanlab.json and contains valid JSON content. The link /files/eval_and_remediate_cleanlab.json correctly maps to this location.

docs/docs/Support/release-notes.mdx (3)

82-82: Documentation link correctly updated.

The link to the Docling bundle correctly references /bundles-docling instead of the old /integrations-docling path, aligning with the documentation reorganization.


101-101: Documentation link correctly updated.

The link to the Composio bundle correctly references /bundles-composio, consistent with the new bundle-based documentation structure.


164-164: Documentation link correctly updated.

The link to the Cleanlab bundle correctly references /bundles-cleanlab, completing the migration from the integrations structure to the bundles structure.

docs/docs/Components/bundles-notion.mdx (6)

1-4: Frontmatter is complete and follows guidelines.

The frontmatter includes the required title and slug fields, and the slug follows the bundle naming pattern /bundles-notion.


164-164: Image verified to exist.

The image file exists at docs/static/img/notion_conversational_agent_tools.png, which correctly corresponds to the markdown reference /img/notion_conversational_agent_tools.png.


84-84: Verified: All referenced JSON files exist.

The downloadable flow JSON files referenced in the documentation have been confirmed to exist at the correct locations:

  • /files/Meeting_Notes_Agent.json → exists at docs/static/files/Meeting_Notes_Agent.json
  • /files/Conversational_Notion_Agent.json → exists at docs/static/files/Conversational_Notion_Agent.json

No issues found.


92-92: Add more descriptive alt text for accessibility.

The image exists at the correct location. However, the current alt text "Notion Meeting Agent Part 1" should be more descriptive about what the image actually shows (e.g., the components, connections, or workflow depicted). According to accessibility guidelines, alt text should describe the content and purpose of the image for users who cannot see it.

Please verify the image content and update the alt text to be more descriptive about what is shown in the screenshot.


116-116: Image verified; alt text is adequate.

The image /img/notion_meeting_agent_part_2.png exists at docs/static/img/notion_meeting_agent_part_2.png. The current alt text "Notion Meeting Agent Part 2" appropriately identifies the subject and indicates it's part of a sequence, which is sufficient for this documentation context.


73-73: Internal link verified and functional.

The link /data-types correctly resolves to docs/docs/Develop/data-types.mdx, which defines slug: /data-types at line 3. This link is used consistently across 73 locations in the documentation without issues.

docs/docusaurus.config.js (2)

342-348: Comprehensive Notion integration migration.

The redirect configuration properly handles the migration from the old Notion integration structure (with separate setup, meeting-notes, and conversational agent pages) to the unified /bundles-notion page. This aligns well with the new bundles-notion.mdx file added in this PR.


181-188: Redirect target verified and exists.

The redirect target /concepts-overview exists at docs/docs/Flows/concepts-overview.mdx. The redirect configuration correctly maps legacy paths (/workspace-overview, /365085a8-a90a-43f9-a779-f8769ec7eca1, /My-Collection, /workspace, /settings-project-general-settings) to the new location.

docs/sidebars.js (5)

362-362: TypeScript client documentation path verified.

The file docs/docs/API-Reference/typescript-client.mdx exists at the expected location. The sidebar reference is correct.


88-90: MCP documentation files verified.

All three MCP documentation files exist in the Agents/ directory:

  • mcp-client.mdx
  • mcp-server.mdx
  • mcp-component-astra.mdx

The sidebar references are correct.


97-160: All referenced files verified to exist.

All 20 documentation files referenced in the reorganized Develop section have been confirmed to exist in docs/docs/Develop/:

  • Storage and memory: concepts-file-management, memory, session-id, configuration-custom-database, enterprise-database-guide
  • Observability/Monitoring: logging, integrations-arize, integrations-langfuse, integrations-langsmith, integrations-langwatch, integrations-opik, integrations-instana-traceloop, contributing-telemetry
  • Other: api-keys-and-authentication, install-custom-dependencies, configuration-global-variables, environment-variables, data-types, concepts-voice-mode, configuration-cli

40-71: All Flows section file paths verified.

All documentation files referenced in lines 40-71 exist at their new Flows/* locations:

  • Flows/concepts-overview.mdx
  • Flows/concepts-flows.mdx
  • Flows/concepts-publish.mdx
  • Flows/webhook.mdx
  • Flows/concepts-playground.mdx
  • Flows/concepts-flows-import.mdx

The path reorganization from Concepts/* to Flows/* is correctly implemented with no broken references.


291-327: All bundle documentation files verified and exist.

All referenced bundle documentation files have been confirmed to exist in the correct location (docs/docs/Components/):

  • bundles-apify.mdx
  • bundles-assemblyai.mdx
  • bundles-cleanlab.mdx
  • bundles-composio.mdx
  • bundles-docling.mdx
  • bundles-google.mdx
  • bundles-notion.mdx
  • bundles-nvidia.mdx
docs/docs/Components/components-data.mdx (2)

604-604: The Composio bundle link target exists and is valid.

The referenced file docs/docs/Components/bundles-composio.mdx exists in the documentation. The link /bundles-composio will resolve correctly.


200-200: The Docling bundle link target exists and is valid.

The file docs/docs/Components/bundles-docling.mdx exists in the documentation, and the /bundles-docling link is correctly referenced in multiple locations including the sidebar configuration and other documentation files. The link is functional.

Comment thread docs/docs/Components/bundles-apify.mdx
Comment thread docs/docs/Components/bundles-assemblyai.mdx
Comment thread docs/docs/Components/bundles-composio.mdx
Comment thread docs/docs/Components/bundles-nvidia.mdx
@github-actions github-actions Bot added documentation Improvements or additions to documentation and removed documentation Improvements or additions to documentation labels Sep 29, 2025
@github-actions

This comment has been minimized.

@github-actions github-actions Bot added documentation Improvements or additions to documentation and removed documentation Improvements or additions to documentation labels Sep 29, 2025
@github-actions

This comment has been minimized.

@mendonk
Copy link
Copy Markdown
Collaborator

mendonk commented Sep 29, 2025

Copy link
Copy Markdown
Collaborator

@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.

LGTM
Consider removing the notion-docs workflow file too.

@github-actions github-actions Bot added the lgtm This PR has been approved by a maintainer label Sep 29, 2025
@github-actions github-actions Bot added documentation Improvements or additions to documentation and removed documentation Improvements or additions to documentation labels Sep 29, 2025
@sonarqubecloud
Copy link
Copy Markdown

@github-actions

This comment has been minimized.

1 similar comment
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Sep 29, 2025

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

@aimurphy aimurphy added this pull request to the merge queue Sep 29, 2025
Merged via the queue into main with commit 55878bf Sep 30, 2025
16 checks passed
@aimurphy aimurphy deleted the lfoss-1977 branch September 30, 2025 00:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation lgtm This PR has been approved by a maintainer

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants