The /llms.txt file is a proposal to standardize a method for providing LLMs with concise, expert-level information about a website. It addresses the limitations of LLM context windows by offering a dedicated markdown file containing background information, guidance, and links to detailed documentation. The format is designed to be both human and machine readable, enabling fixed processing methods. The proposal includes generating markdown versions of existing HTML pages (appending .md to the URL). This initiative aims to improve LLM performance in various applications, from software documentation to complex legal analysis, and is already being implemented in projects like FastHTML and nbdev.
Create executable demo documents that show and prove an agent's work. Showboat helps agents build markdown documents that mix commentary, executable code blocks, and captured output. These documents serve as both readable documentation and reproducible proof of work. A verifier can re-execute all code blocks and confirm the outputs still match.
The importance of project documentation is emphasized through a personal anecdote, and an introduction to using MkDocs for creating beautiful documentation pages using Markdown.
Mermaid is a JavaScript-based diagramming and charting tool that renders Markdown-inspired text definitions to create and modify complex diagrams. It enables users to create easily modifiable diagrams and integrates with various applications.