Add Building with AI documentation page #2175
Conversation
|
Preview is available here: |
|
Preview is available here: |
ElliotFriend
left a comment
ElliotFriend
left a comment
There was a problem hiding this comment.
one small nit, but otherwise looks great!
Co-authored-by: Elliot Voris <elliot@stellar.org>
There was a problem hiding this comment.
Pull request overview
This PR adds a new documentation page that guides developers on how to use Stellar documentation with AI tools and assistants. It introduces the llms.txt standard and provides practical instructions for integrating Stellar development context into various AI platforms.
Changes:
- Added a new "Building with AI" documentation page explaining how to leverage Stellar docs with AI assistants
- Updated the routes configuration to include the new documentation page in the proper navigation order
- Provided specific instructions for popular AI tools including Cursor, ChatGPT, Claude, and Gemini
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.
| File | Description |
|---|---|
| routes.txt | Added route entry for the new building-with-ai documentation page |
| docs/tools/developer-tools/building-with-ai.mdx | New comprehensive guide covering llms.txt usage, AI assistant integration instructions, and links to Stella |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| ## Using with AI assistants | ||
|
|
||
| ### ChatGPT, Claude, and other LLMs | ||
|
|
||
| You can paste the contents of `llms.txt` into your conversation to give the AI context about Stellar: |
There was a problem hiding this comment.
The section heading 'ChatGPT, Claude, and other LLMs' appears before detailed subsections for ChatGPT (line 65), Claude (line 73), and Gemini (line 81). This creates a structural inconsistency where general instructions are given under this heading, but specific tool instructions appear later as subsections under 'AI-powered coding assistants'. Consider restructuring to have 'ChatGPT, Claude, and other LLMs' as a subsection at the same level as 'Cursor', 'ChatGPT', 'Claude', and 'Gemini' under the 'AI-powered coding assistants' section, or clarify that the initial section (lines 24-31) is for general use while the later sections are for coding-specific features.
| ## Using with AI assistants | |
| ### ChatGPT, Claude, and other LLMs | |
| You can paste the contents of `llms.txt` into your conversation to give the AI context about Stellar: | |
| ## Using chat-based AI assistants | |
| ### General LLM usage | |
| You can use `llms.txt` with any chat-based AI assistant (such as ChatGPT, Claude, Gemini, or other LLMs) by pasting its contents into your conversation to give the AI context about Stellar: |
|
|
||
| ### AI-powered coding assistants | ||
|
|
||
| Tools like GitHub Copilot, Cursor, Claude or Gemini can benefit from having `llms.txt` in your project context when working on Stellar-related code. |
There was a problem hiding this comment.
The sentence lists tools without consistent punctuation (missing comma before 'or'). Should be: 'Tools like GitHub Copilot, Cursor, Claude, or Gemini can benefit from having llms.txt in your project context when working on Stellar-related code.'
| Tools like GitHub Copilot, Cursor, Claude or Gemini can benefit from having `llms.txt` in your project context when working on Stellar-related code. | |
| Tools like GitHub Copilot, Cursor, Claude, or Gemini can benefit from having `llms.txt` in your project context when working on Stellar-related code. |
| title: Building with AI | ||
| description: Use Stellar documentation with AI assistants and Large Language Models | ||
| sidebar_label: Building with AI | ||
| sidebar_position: 118 |
There was a problem hiding this comment.
The sidebar_position value of 118 places this page after 'Stella AI Bot' (position 117) but creates a significant gap from the previous pages in the sequence (Security Tools at 115). Consider using position 116 instead to maintain a more sequential ordering, unless there's an intentional gap for future content.
| sidebar_position: 118 | |
| sidebar_position: 116 |
|
Preview is available here: |
Adds a new documentation page explaining how to use Stellar docs with AI tools. Covers llms.txt usage, instructions for Cursor, ChatGPT, Claude, and Gemini, and links to Stella.