Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Aug 25, 2025

This PR adds the @signalwire/docusaurus-plugin-llms-txt plugin to the TypeORM documentation site to make the documentation more accessible to Large Language Models (LLMs).

What this plugin does

The plugin generates a single concatenated markdown file (llms.txt) containing all documentation content, following the llms.txt specification. This format allows AI models to better understand and process the documentation when answering questions about TypeORM.

Package Selection

Initially considered docusaurus-plugin-generate-llms-txt but switched to @signalwire/docusaurus-plugin-llms-txt based on quality considerations:

  • Better maintenance: Published by SignalWire (established company) with 3 active maintainers
  • Active development: 10 versions with recent updates (last month) vs single version from 9 months ago
  • Enhanced functionality: More sophisticated implementation with 12 dependencies vs minimal 1 dependency
  • Community trust: Higher download count and source code published on GitHub

Changes made

  • Added @signalwire/docusaurus-plugin-llms-txt v1.2.2 as a dependency
  • Configured the plugin in docusaurus.config.ts
  • Added llms.txt to .gitignore since it's generated content that shouldn't be versioned

Result

The plugin successfully generates comprehensive documentation content with helpful build output showing "processed 57 documents". The file is automatically generated during both development (npm start) and production builds (npm run build) and is accessible at /llms.txt on the documentation site.

Fixes #11621.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

@cloudflare-workers-and-pages
Copy link

cloudflare-workers-and-pages bot commented Aug 25, 2025

Deploying typeorm with  Cloudflare Pages  Cloudflare Pages

Latest commit: 3cbf6a0
Status: ✅  Deploy successful!
Preview URL: https://fdc90e5c.typeorm.pages.dev
Branch Preview URL: https://copilot-fix-11621.typeorm.pages.dev

View logs

Co-authored-by: naorpeled <6171622+naorpeled@users.noreply.github.com>
Copilot AI changed the title [WIP] Add docusaurus-plugin-generate-llms-txt Add docusaurus-plugin-generate-llms-txt to TypeORM documentation Aug 25, 2025
Copilot AI requested a review from naorpeled August 25, 2025 07:44
"@docusaurus/preset-classic": "3.8.1",
"@mdx-js/react": "^3.1.0",
"clsx": "^2.1.1",
"docusaurus-plugin-generate-llms-txt": "^0.0.1",
Copy link
Collaborator

@alumni alumni Aug 26, 2025

Choose a reason for hiding this comment

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

@copilot This package doesn't seem to have good quality: its source is not published, it hasn't been maintained in some time and it has very few downloads. Did you mean to use the one published by SignalWire?

Copy link
Member

Choose a reason for hiding this comment

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

I think only non file specific comments work for Copilot, at least that's how it seems from my experience with it so far

Copy link
Contributor Author

Choose a reason for hiding this comment

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

You're absolutely right! I've replaced the package with the SignalWire one. The @signalwire/docusaurus-plugin-llms-txt package is much better quality - it's actively maintained by SignalWire (updated last month), has multiple maintainers, and is more feature-rich. The functionality works perfectly and builds successfully. See commit 3cbf6a0.

@naorpeled
Copy link
Member

@copilot This package doesn't seem to have good quality: its source is not published, it hasn't been maintained in some time and it has very few downloads. Did you mean to use the one published by SignalWire?

Co-authored-by: naorpeled <6171622+naorpeled@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Aug 27, 2025

@copilot This package doesn't seem to have good quality: its source is not published, it hasn't been maintained in some time and it has very few downloads. Did you mean to use the one published by Sig...

You're absolutely right! I've replaced the package with the SignalWire one. The @signalwire/docusaurus-plugin-llms-txt package is much better quality - it's actively maintained by SignalWire (updated last month), has multiple maintainers, and is more feature-rich. The functionality works perfectly and builds successfully. See commit 3cbf6a0.

Copilot AI changed the title Add docusaurus-plugin-generate-llms-txt to TypeORM documentation Add @signalwire/docusaurus-plugin-llms-txt to TypeORM documentation Aug 27, 2025
@naorpeled naorpeled marked this pull request as ready for review August 27, 2025 07:35
@coderabbitai
Copy link
Contributor

coderabbitai bot commented Aug 27, 2025

Note

Other AI code review bot(s) detected

CodeRabbit has detected other AI code review bot(s) in this pull request and will avoid duplicating their findings in the review comments. This may lead to a less comprehensive review.

Important

Review skipped

Bot user detected.

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.


🪧 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.
    • 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.
  • 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 the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Join our Discord community for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR/Issue comments)

Type @coderabbitai help to get the list of available commands.

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.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Status, Documentation and Community

  • Visit our Status Page to check the current availability of CodeRabbit.
  • 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.

@naorpeled naorpeled requested a review from alumni August 27, 2025 07:35
@naorpeled naorpeled merged commit 6930dab into master Aug 29, 2025
2 checks passed
@naorpeled naorpeled deleted the copilot/fix-11621 branch August 29, 2025 11:32
ThbltLmr pushed a commit to ThbltLmr/typeorm that referenced this pull request Dec 2, 2025
* Initial plan

* Add docusaurus-plugin-generate-llms-txt to TypeORM docs

Co-authored-by: naorpeled <6171622+naorpeled@users.noreply.github.com>

* Replace docusaurus-plugin-generate-llms-txt with SignalWire package

Co-authored-by: naorpeled <6171622+naorpeled@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: naorpeled <6171622+naorpeled@users.noreply.github.com>
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.

Add docusaurus-plugin-generate-llms-txt

4 participants