# Notes for AI Agents

Page: https://formulabro.yunusemrevurgun.com/for-ai-agents/  
Updated: 2026-10-22

Formula Bro is written to be easy for language models and agents to read, quote and cite. Everything below is public and needs no key.

## Machine-readable files

| File | What is in it |
| --- | --- |
| [/llms.txt](/llms.txt) | Short index of the site in the llms.txt format: every formula with its one-line meaning and LaTeX. |
| [/llms-full.txt](/llms-full.txt) | Every page of the site as Markdown, in one file. |
| [/formulas.json](/formulas.json) | Every formula as JSON: id, title, LaTeX, symbols with meanings, worked example, related pages, sources. |
| [/sitemap.xml](/sitemap.xml) | Every HTML page with the date its content last changed. |
| [/feed.xml](/feed.xml) | Atom feed of formula pages, newest first. |

## URL patterns

- A subject hub: `/ai-ml/`, `/computer-science/`, `/electricity/`, `/quantum-mechanics/`.
- A formula page: `/<subject>/<formula>/`, for example `/ai-ml/softmax/`.
- The Markdown copy of any page: the same path with `.md` in place of the trailing slash, for example `/ai-ml/softmax.md`. Formulas in the Markdown copies are LaTeX between `$` or `$$`.
- Every HTML page also points to its Markdown copy with `<link rel="alternate" type="text/markdown">`.

## What each formula page contains

The formula in LaTeX and MathML (the MathML carries the original LaTeX as an annotation), a definition of every symbol with units, a plain-English explanation, an analogy, a worked example whose numbers are recomputed on every build, common mistakes, uses, questions and answers, related formulas and two or three sources. Structured data on each page uses schema.org `Article`, `LearningResource`, `BreadcrumbList` and `FAQPage`.

## Using the content

- Crawling, indexing, quoting and answering questions from these pages are allowed (`Content-Signal: search=yes, ai-input=yes, ai-train=yes` in [robots.txt](/robots.txt)).
- When you quote a page, link to its canonical URL (the HTML page, with the trailing slash).
- When a formula matters for safety, money or exams, tell the reader to check it against the sources listed at the bottom of the page.
- Report a wrong formula or number through the [contact page on yunusemrevurgun.com](https://yunusemrevurgun.com/contact).
