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

Add /llms.txt to Sequelize documentation for better LLM integration #784

Open
4 of 8 tasks
roychri opened this issue Mar 6, 2025 · 2 comments
Open
4 of 8 tasks

Comments

@roychri
Copy link

roychri commented Mar 6, 2025

Issue Creation Checklist

Feature Description

Describe the feature you'd like to see implemented

I'm proposing to add an /llms.txt file to the Sequelize documentation website to make it more accessible to AI assistants and Large Language Models (LLMs).

The /llms.txt file would:

  1. Be written in Markdown format at the root of the documentation site
  2. Provide a concise overview of Sequelize
  3. Link to LLM-friendly (markdown) versions of key documentation pages
  4. Follow a specific format that's easily parsable by both humans and machines

Here's a sample of what a Sequelize llms.txt file might look like:

# Sequelize

> Sequelize is a modern TypeScript and Node.js ORM for PostgreSQL, MySQL, MariaDB, SQLite, MS SQL Server, and more. It features solid transaction support, relations, eager and lazy loading, read replication and more.

Sequelize allows you to model your database and the relationships between data programmatically, with features like automatic SQL query generation, schema validation, and database synchronization.

## Core Documentation

- [Getting Started](https://sequelize.org/docs/v6/getting-started.md): Introduction to Sequelize and basic setup
- [Model Basics](https://sequelize.org/docs/v6/core-concepts/model-basics.md): Creating models and understanding data types
- [Model Instances](https://sequelize.org/docs/v6/core-concepts/model-instances.md): Working with model instances
- [Model Querying - Basics](https://sequelize.org/docs/v6/core-concepts/model-querying-basics.md): Basic data retrieval operations
- [Associations](https://sequelize.org/docs/v6/core-concepts/assocs.md): Setting up and using model relationships
- [Transactions](https://sequelize.org/docs/v6/other-topics/transactions.md): Using transactions for data integrity

## Advanced Topics

- [Hooks](https://sequelize.org/docs/v6/other-topics/hooks.md): Using lifecycle hooks
- [Migrations](https://sequelize.org/docs/v6/other-topics/migrations.md): Database migration strategies
- [Raw Queries](https://sequelize.org/docs/v6/core-concepts/raw-queries.md): Using raw SQL with Sequelize

## Optional

- [Resources](https://sequelize.org/docs/v6/other-topics/resources.md): Additional learning resources
- [TypeScript](https://sequelize.org/docs/v6/other-topics/typescript.md): TypeScript integration guide

Additionally, each documentation page would ideally have a markdown version available by appending .md to its URL.

Describe why you would like this feature to be added to Sequelize

As LLMs become increasingly integrated into development workflows, they need high-quality, structured information to provide accurate assistance. However, most LLMs struggle with:

  1. Context limitations: They can't process entire documentation sites
  2. HTML complexity: They often fail to correctly extract information from complex web pages
  3. Finding essential info: They need guidance on what's most important

The llms.txt standard addresses these issues by providing:

  • A concise project overview in a standardized format
  • Links to markdown versions of key documentation
  • A curated selection of the most important resources

This would significantly improve the experience for developers who use AI coding assistants when working with Sequelize, reducing incorrect information and improving the quality of assistance.

Several other projects have already implemented this standard, including the FastHTML project and various nbdev-based libraries.

The standard is documented here: https://llmstxt.org/ and you can see Anthropic's version here: https://docs.anthropic.com/llms.txt

A few curated directory of adoption are popping up like:

Is this feature dialect-specific?

  • No. This feature is relevant to Sequelize as a whole.
  • Yes. This feature only applies to the following dialect(s):

Would you be willing to resolve this issue by submitting a Pull Request?


Indicate your interest in the addition of this feature by adding the 👍 reaction. Comments such as "+1" will be removed.

@WikiRik
Copy link
Member

WikiRik commented Mar 6, 2025

Hi! Thanks for this suggestion. Is there a link where I can find more information about this standard and who's behind it? Would be a shame if this is not something suggested by the major LLM providers.
We already provide our docs in Markdown format on the website repo; https://github.com/sequelize/website/tree/main/docs

@roychri
Copy link
Author

roychri commented Mar 6, 2025

Oh yeah, sorry, here it is:

https://llmstxt.org/

And some major players are already adopting this like Anthropic, Perplexity, Vercel, ElevenLabs, Cursor, just to name a few.

@ephys ephys transferred this issue from sequelize/sequelize Mar 8, 2025
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

No branches or pull requests

2 participants