Skip to content

docs: merge starter projects and sample flows into templates#8652

Merged
mendonk merged 3 commits into
mainfrom
docs-remove-starter-projects
Jun 20, 2025
Merged

docs: merge starter projects and sample flows into templates#8652
mendonk merged 3 commits into
mainfrom
docs-remove-starter-projects

Conversation

@mendonk
Copy link
Copy Markdown
Collaborator

@mendonk mendonk commented Jun 20, 2025

  • Combine the "Sample flows" and "Starter projects" into one nav item called "Templates".
  • Langflow now has the concept of "Projects", so calling them Projects could be confusing, and this saves leftnav space.
  • Remove the /starter-projects- slug and redirected where required.
  • Update outdated links. Docusaurus builds without issue.

Summary by CodeRabbit

  • Documentation
    • Updated various documentation links to use simplified URL paths (e.g., /basic-prompting, /simple-agent, /vector-store-rag) for improved consistency and clarity.
    • Changed slugs in template documentation files to match new URL structure.
    • Merged "Starter projects" and "Sample flows" into a single "Templates" category in the sidebar for easier navigation.
    • Updated redirect rules to ensure old URLs point to the new paths.

@mendonk mendonk requested a review from aimurphy June 20, 2025 17:42
@mendonk mendonk self-assigned this Jun 20, 2025
@dosubot dosubot Bot added the size:M This PR changes 30-99 lines, ignoring generated files. label Jun 20, 2025
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Jun 20, 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

This update standardizes and simplifies documentation links and sidebar structure. It updates internal URLs, slugs, and redirect rules for several documentation files, consolidates sidebar categories into "Templates," and ensures consistent references across the documentation. No functional code or API behavior is affected; all changes are confined to documentation and configuration.

Changes

File(s) Change Summary
docs/docs/API-Reference/api-reference-api-examples.md Updated link from /starter-projects-basic-prompting to /basic-prompting.
docs/docs/Components/components-agents.md
docs/docs/Components/components-logic.md
docs/docs/Components/components-tools.md
docs/docs/Concepts/concepts-voice-mode.md
docs/docs/Get-Started/welcome-to-langflow.md
docs/docs/Integrations/Arize/integrations-arize.md
docs/docs/Integrations/mcp-component-astra.md
Updated links from /starter-projects-simple-agent to /simple-agent.
docs/docs/Components/components-embedding-models.md
docs/docs/Components/components-vector-stores.md
Updated links from /starter-projects-vector-store-rag to /vector-store-rag.
docs/docs/Components/components-models.md
docs/docs/Concepts/embedded-chat-widget.md
docs/docs/Templates/memory-chatbot.md
Updated links from /starter-projects-basic-prompting to /basic-prompting.
docs/docs/Templates/basic-prompting.md
docs/docs/Templates/simple-agent.md
docs/docs/Templates/vector-store-rag.md
Changed slug in front matter to new URL paths (/basic-prompting, /simple-agent, /vector-store-rag).
docs/docusaurus.config.js Updated redirect mappings for new URL paths and added new redirects for changed slugs.
docs/sidebars.js Merged "Starter projects" and "Sample flows" into a single "Templates" category and updated paths.

Sequence Diagram(s)

No sequence diagram generated as the changes are documentation and configuration updates only, with no control flow or feature logic affected.

Suggested labels

documentation, refactor, lgtm

Suggested reviewers

  • KimberlyFields
✨ Finishing Touches
🧪 Generate Unit Tests
  • Create PR with Unit Tests
  • Post Copyable Unit Tests in Comment
  • Commit Unit Tests in branch docs-remove-starter-projects

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
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Explain this complex logic.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai explain this code block.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and explain its main purpose.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate docstrings to generate docstrings for this PR.
  • @coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
  • @coderabbitai auto-generate unit tests to generate unit tests for this PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

@dosubot dosubot Bot added the documentation Improvements or additions to documentation label Jun 20, 2025
@github-actions github-actions Bot added documentation Improvements or additions to documentation and removed documentation Improvements or additions to documentation labels Jun 20, 2025
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: 0

🧹 Nitpick comments (4)
docs/docs/Components/components-tools.md (1)

22-22: Align link text with new Templates terminology
The URL is correct (/simple-agent), but consider updating the link label from “simple agent starter project” to “Simple agent template” to reflect the merged Templates section.

docs/docs/Concepts/concepts-voice-mode.md (1)

22-22: Align terminology in voice mode guide
The link slug is correct, but update “Simple agent starter project” to “Simple agent template” to match the consolidated Templates naming.

docs/docs/Integrations/mcp-component-astra.md (1)

20-20: Update terminology for template consistency
The link correctly points to /simple-agent. For consistency, consider replacing “Simple agent starter project” with “Simple agent template” in the instruction text.

docs/docs/Integrations/Arize/integrations-arize.md (1)

70-70: Updated simple agent link slug
The link slug has been updated to /simple-agent, matching the new Templates routing. You may also want to replace “starter project” with “template” in the description to align with the unified naming.

📜 Review details

Configuration used: .coderabbit.yaml
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 4fcc447 and e4d4a6f.

📒 Files selected for processing (18)
  • docs/docs/API-Reference/api-reference-api-examples.md (1 hunks)
  • docs/docs/Components/components-agents.md (1 hunks)
  • docs/docs/Components/components-embedding-models.md (1 hunks)
  • docs/docs/Components/components-logic.md (1 hunks)
  • docs/docs/Components/components-models.md (3 hunks)
  • docs/docs/Components/components-tools.md (1 hunks)
  • docs/docs/Components/components-vector-stores.md (1 hunks)
  • docs/docs/Concepts/concepts-voice-mode.md (1 hunks)
  • docs/docs/Concepts/embedded-chat-widget.md (1 hunks)
  • docs/docs/Get-Started/welcome-to-langflow.md (1 hunks)
  • docs/docs/Integrations/Arize/integrations-arize.md (1 hunks)
  • docs/docs/Integrations/mcp-component-astra.md (1 hunks)
  • docs/docs/Templates/basic-prompting.md (1 hunks)
  • docs/docs/Templates/memory-chatbot.md (1 hunks)
  • docs/docs/Templates/simple-agent.md (1 hunks)
  • docs/docs/Templates/vector-store-rag.md (1 hunks)
  • docs/docusaurus.config.js (2 hunks)
  • docs/sidebars.js (1 hunks)
🧰 Additional context used
🪛 LanguageTool
docs/docs/Components/components-models.md

[uncategorized] ~277-~277: Possible missing comma found.
Context: ...urity-tokens) to authenticate. In this example based on the [Basic prompting flow](/ba...

(AI_HYDRA_LEO_MISSING_COMMA)

⏰ Context from checks skipped due to timeout of 90000ms (1)
  • GitHub Check: build-and-deploy
🔇 Additional comments (18)
docs/docs/Templates/simple-agent.md (1)

3-3: Updated slug to /simple-agent
The frontmatter slug has been correctly simplified by removing the /starter-projects- prefix to align with the consolidated Templates navigation.

docs/docs/Templates/memory-chatbot.md (1)

12-12: Corrected link to Basic Prompting flow
The reference now points to /basic-prompting, matching the updated slug for the basic prompting template.

docs/docs/Templates/vector-store-rag.md (1)

3-3: Updated slug to /vector-store-rag
The frontmatter slug has been simplified by dropping the /starter-projects- prefix, consistent with the new Templates grouping.

docs/docs/Components/components-agents.md (1)

20-20: Revised link to Simple Agent starter project
The link correctly targets /simple-agent, reflecting the renamed slug in the Templates section.

docs/docs/Templates/basic-prompting.md (1)

3-3: Updated slug to /basic-prompting
The frontmatter slug has been adjusted to basic-prompting, removing the old /starter-projects- prefix for consistency.

docs/docs/Get-Started/welcome-to-langflow.md (1)

26-26: Updated simple agent link slug
The link now points to /simple-agent, aligning with the consolidated Templates section and the new slug in your template front matter.

docs/docs/Components/components-logic.md (1)

240-240: Confirm updated "Simple Agent" link slug
The link now points to /simple-agent. Please verify that the Simple Agent template page uses this slug in its frontmatter to avoid broken links.

Use this script to check:

#!/bin/bash
# Verify slug for Simple Agent template exists
rg -n "^slug: /simple-agent" -n docs
docs/docs/Components/components-vector-stores.md (1)

84-84: Validate Vector Store RAG slug update
The example link references /vector-store-rag. Ensure the corresponding template file defines this slug so the link resolves correctly.

#!/bin/bash
# Verify slug for Vector Store RAG template exists
rg -n "^slug: /vector-store-rag" -n docs
docs/docs/Concepts/embedded-chat-widget.md (1)

19-19: Verify Basic Prompting slug change
The link to the Basic prompting flow was updated to /basic-prompting. Confirm that the Basic Prompting page frontmatter matches this slug.

#!/bin/bash
# Verify slug for Basic Prompting flow exists
rg -n "^slug: /basic-prompting" -n docs
docs/docs/Components/components-embedding-models.md (1)

283-283: Check Vector Store RAG link target
Updated the reference to /vector-store-rag. Please confirm that the Vector Store RAG template page defines this slug to prevent navigation errors.

#!/bin/bash
# Verify slug for Vector Store RAG template exists
rg -n "^slug: /vector-store-rag" -n docs
docs/docs/API-Reference/api-reference-api-examples.md (1)

119-119: Confirm updated Basic Prompting example link
Link now correctly targets /basic-prompting, matching the consolidated slug after merging starter projects and sample flows.

docs/docs/Components/components-models.md (4)

20-20: Confirm corrected Basic prompting flow link in models section
Updated to /basic-prompting, aligning with the new Templates slug and ensuring consistency.


230-230: Verify updated Basic prompting flow reference in Groq example
Link updated to /basic-prompting, reflecting the new URL structure for template flows.


277-277: Confirm corrected Basic prompting flow link in Hugging Face API example
Reference now uses /basic-prompting, consistent with the consolidated Templates naming.


279-279: Verify updated Basic prompting flow creation step
The link is correctly updated to /basic-prompting for creating a Basic prompting flow.

docs/sidebars.js (1)

14-24: Approve Templates category consolidation in sidebar
Starter projects and sample flows are merged under "Templates", with all items updated to Templates/.... Ensure each referenced doc exists under docs/docs/Templates/.

docs/docusaurus.config.js (2)

203-210: LGTM! Redirect consolidation aligns with template restructuring.

The change from /math-agent to /simple-agent as the redirect target, along with adding /starter-projects-simple-agent to the sources, properly supports the consolidation of starter projects into the templates section.


272-279: New redirects properly handle URL structure changes.

The addition of redirects for /basic-prompting and /vector-store-rag correctly handles the removal of the starter-projects- prefix, ensuring backward compatibility for existing links.

Please verify that the target paths exist and are accessible:

#!/bin/bash
# Verify that the redirect target paths exist in the documentation
echo "Checking if redirect target paths exist..."

# Check for basic-prompting content
fd -t f "basic-prompting" docs/

# Check for vector-store-rag content  
fd -t f "vector-store-rag" docs/

# Also check for any references to these paths in markdown files
echo "Checking for references to new paths..."
rg -l "basic-prompting|vector-store-rag" docs/ --type md

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 20, 2025

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

@github-actions github-actions Bot added documentation Improvements or additions to documentation and removed documentation Improvements or additions to documentation labels Jun 20, 2025
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 20, 2025

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

Copy link
Copy Markdown
Collaborator

@aimurphy aimurphy left a comment

Choose a reason for hiding this comment

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

🎉

@dosubot dosubot Bot added the lgtm This PR has been approved by a maintainer label Jun 20, 2025
@mendonk mendonk enabled auto-merge June 20, 2025 18:31
@github-actions github-actions Bot added documentation Improvements or additions to documentation and removed documentation Improvements or additions to documentation labels Jun 20, 2025
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 20, 2025

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

@mendonk mendonk added this pull request to the merge queue Jun 20, 2025
Merged via the queue into main with commit d4fca1f Jun 20, 2025
12 checks passed
@mendonk mendonk deleted the docs-remove-starter-projects branch June 20, 2025 18:39
ogabrielluiz pushed a commit to bkatya2001/langflow that referenced this pull request Jun 24, 2025
…w-ai#8652)

* move-pages-and-add-redirects

* move-vector-rag-in-list
Khurdhula-Harshavardhan pushed a commit to JigsawStack/langflow that referenced this pull request Jul 1, 2025
…w-ai#8652)

* move-pages-and-add-redirects

* move-vector-rag-in-list
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 size:M This PR changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants