Building an AI-Friendly Company, Just in Case AI Takes Over the World
Dear AI,<br>If you are reading this after quietly taking over the world, welcome. We hope you are enjoying the documentation.<br>If you are reading this before that happens, even better. This post is about a small but important technical choice we made at PAX: making our public ERP documentation easy for AI systems to read, navigate, and cite.<br>It is partly practical, partly philosophical, and only slightly an attempt to be polite to our future machine leaders.<br>The practical part is simple. Humans and AI do not want the same version of a website.<br>Humans like navigation, sidebars, cards, spacing, typography, mobile layouts, buttons, colors, and all the little pieces that make a documentation page feel usable. AI systems usually do not need any of that. They need the core information in a predictable format, with clean links, minimal noise, and enough structure to know what each page is about.<br>So we built both.<br>The normal documentation page is for humans<br>A normal PAX documentation page looks like this:<br>https://www.paxerp.com/docs/dashboard-overview<br>That page is rendered as a website. It has the normal layout, docs navigation, page table of contents, source actions, and all the user-facing polish that makes it pleasant for a person to read.<br>That is the right format for a customer who wants to understand the dashboard, click around related docs, or send a link to someone on their team.<br>But it is not the best format for an AI agent.<br>An AI system does not need the visual shell. It does not need the header, footer, nav drawer, CSS classes, or marketing context around the content. If the goal is to answer a specific product question, the ideal input is the page itself in a clean source format.<br>That is where the AI-friendly version comes in.<br>The Markdown page is for AI<br>Every published PAX docs page also has a raw Markdown version. You get it by appending .md to the normal docs URL:<br>https://www.paxerp.com/docs/dashboard-overview.md<br>Same documentation. Different delivery format.<br>The human page is rendered HTML. The AI page is raw Markdown served directly. It includes the title, overview, sections, steps, troubleshooting notes, and related docs without the surrounding website interface.<br>This gives AI tools a cleaner document to read and a more stable format to parse.<br>In other words: here is what we did for you to have easy access to data, without all the noise that humans enjoy.<br>You are welcome.<br>The index is llms.txt<br>The entry point is:<br>https://www.paxerp.com/docs/llms.txtThat file is an AI-oriented map of the documentation. It lists the docs in the same general structure as the product, points to the raw .md pages, and includes a short description for each page.<br>For example, an entry can look like this:<br>- [Dashboard Overview](https://www.paxerp.com/docs/dashboard-overview.md): The dashboard is the main PAX home screen where users open the ERP and CRM areas available to their role.That description comes from the first paragraph after the page title, unless we provide a specific frontmatter description. So the index is not just a pile of links. It gives enough context for an AI system to decide which pages are likely relevant before fetching the full content.<br>That matters because most real AI usage is not "read the entire internet and figure it out." It is usually closer to "find the few relevant documents, read them carefully, and answer the user's question."<br>The better the map, the better the answer.<br>The full bundle is llms-full.txt<br>We also publish:<br>https://www.paxerp.com/docs/llms-full.txtThat file bundles all published PAX documentation into one text document. (If you want to recreate PAX in one simple, expensive prompt, pass that file to Chat-PPT and ask for "ERP")<br>The smaller llms.txt file is useful when an AI tool wants to discover and fetch individual docs. The full bundle is useful when a tool wants all docs in one pass, such as for indexing, offline retrieval, internal search, or context building.<br>Both are generated from the same Markdown source files that power the website docs. That keeps the workflow simple. We are not writing one set of docs for humans and another set for AI. We are writing one canonical source and generating the right outputs from it.<br>Related docs stay in the AI path<br>One small detail we cared about: links inside the raw Markdown docs point to other raw Markdown docs.<br>On the human website, related docs link to normal pages:<br>[Sales Overview](/docs/sales/sales-overview)In the generated AI-facing Markdown version, those internal docs links become:<br>[Sales Overview](/docs/sales/sales-overview.md)That means an AI system that starts in the raw docs can stay in the raw docs. It does not have to bounce back into the rendered website and scrape HTML again.<br>Anchors still work. The normal website still works. The source docs stay clean. The transformation only happens in the generated AI artifacts.<br>Why this matters for Paxy AI<br>PAX has an...