pyproject.toml (1)

168-170: Build tasks updated to use new naming convention
Aligns with CHANGES.md and the llmtxt.dev guidance.

Consider ensuring the build/llm directory exists before copying to avoid errors on a clean build:

- { shell = "cp src/index/cratedb-overview.md build/llm/" },
+ { shell = "mkdir -p build/llm && cp src/index/cratedb-overview.md build/llm/" },

CHANGES.md (1)

5-6: Clarify list phrasing
The bullet uses “vs.” which may imply contrast rather than inclusion. To make it explicit that both files are used, consider:

- - Naming things: Adhered to the naming convention of https://llmtxt.dev/hub
-   by using `llms.txt` vs. `llms-full.txt`.
+ - Naming things: Adhered to the naming convention of https://llmtxt.dev/hub
+   by using `llms.txt` and `llms-full.txt`.

build/llm/README.md (1)

14-19: Document the directory contents
The “What’s inside” section clearly enumerates the three key files.

• Title-case the heading (“What’s Inside”) for consistency with other top‐level headings.
• In the first bullet, streamline “generating llms.txt from” to “generating llms.txt” for clarity.

🧰 Tools

🪛 LanguageTool

[uncategorized] ~16-~16: Loose punctuation mark.
Context: ...# What's inside - cratedb-overview.md: The source file for generating `llms.tx...

(UNLIKELY_OPENING_PUNCTUATION)

---

[uncategorized] ~17-~17: Loose punctuation mark.
Context: ...generating llms.txt from. - llms.txt: Standard llms.txt file. - `llms-full....

(UNLIKELY_OPENING_PUNCTUATION)

---

[uncategorized] ~18-~18: Loose punctuation mark.
Context: ...ndard llms.txt file. - llms-full.txt: Full llms.txt file, including the "Op...

(UNLIKELY_OPENING_PUNCTUATION)

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

CHANGES.md (1)

5-6: Replace bare URL with a Markdown link.

Markdown style guidelines (e.g., MD034 no-bare-urls) discourage bare URLs. Consider using a descriptive link instead of https://llmtxt.dev/hub inline.

Apply this diff:

- - Naming things: Adhered to the naming convention of https://llmtxt.dev/hub
+ - Naming things: Adhered to the naming convention of [LLM Text Hub](https://llmtxt.dev/hub)

🧰 Tools

🪛 markdownlint-cli2 (0.17.2)

5-5: Bare URL used
null

(MD034, no-bare-urls)

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

build/llm/README.md (1)

16-18: Remove trailing periods from list items for consistency
To keep list items concise and adhere to the straightforward language style (per your earlier learnings), drop the final period on each bullet.

- - `cratedb-overview.md`: The source file for generating `llms.txt`.
+ - `cratedb-overview.md`: The source file for generating `llms.txt`
- - `llms.txt`: Standard `llms.txt` file.
+ - `llms.txt`: Standard `llms.txt` file
- - `llms-full.txt`: Full `llms.txt` file, including the "Optional" subsection.
+ - `llms-full.txt`: Full `llms.txt` file, including the "Optional" subsection

🧰 Tools

🪛 LanguageTool

[uncategorized] ~16-~16: Loose punctuation mark.
Context: ...# What's Inside - cratedb-overview.md: The source file for generating `llms.tx...

(UNLIKELY_OPENING_PUNCTUATION)

---

[uncategorized] ~17-~17: Loose punctuation mark.
Context: ... for generating llms.txt. - llms.txt: Standard llms.txt file. - `llms-full....

(UNLIKELY_OPENING_PUNCTUATION)

---

[uncategorized] ~18-~18: Loose punctuation mark.
Context: ...ndard llms.txt file. - llms-full.txt: Full llms.txt file, including the "Op...

(UNLIKELY_OPENING_PUNCTUATION)

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

Learnt from: amotl
PR: crate/about#0
File: :0-0
Timestamp: 2025-04-16T14:16:33.171Z
Learning: When creating content for an `llms.txt` file (following the llmstxt.org specification), consistent and straightforward language takes precedence over stylistic variation since the primary audience is language models rather than human readers.

Learnt from: amotl
PR: crate/about#0
File: :0-0
Timestamp: 2025-04-16T14:20:35.508Z
Learning: When creating content for an `llms.txt` file (following the llmstxt.org specification), consistent and straightforward language takes precedence over stylistic variation since the primary audience is language models rather than human readers.

Learnt from: amotl
PR: crate/about#0
File: :0-0
Timestamp: 2025-04-16T14:20:35.508Z
Learning: When creating content for an `llms.txt` file (following the llmstxt.org specification), consistent and straightforward language takes precedence over stylistic variation since the primary audience is language models rather than human readers.

Learnt from: amotl
PR: crate/about#0
File: :0-0
Timestamp: 2025-04-16T14:16:33.171Z
Learning: When creating content for an `llms.txt` file (following the llmstxt.org specification), consistent and straightforward language takes precedence over stylistic variation since the primary audience is language models rather than human readers.

Learnt from: amotl
PR: crate/about#0
File: :0-0
Timestamp: 2025-04-16T14:20:35.508Z
Learning: When creating content for an `llms.txt` file (following the llmstxt.org specification), consistent and straightforward language takes precedence over stylistic variation since the primary audience is language models rather than human readers.

Learnt from: amotl
PR: crate/about#0
File: :0-0
Timestamp: 2025-04-16T14:20:35.508Z
Learning: When creating content for an `llms.txt` file (following the llmstxt.org specification), consistent and straightforward language takes precedence over stylistic variation since the primary audience is language models rather than human readers.