docs: add llms.txt and llms-full.txt support (#2298)

Author: andrii-bodnar

README.md

@@ -100,6 +100,15 @@ Contribution to open-source project is everything from spreading the word, writi
 
 This project exists thanks to [all the people][Contributors] who contribute. [[Contribute](CONTRIBUTING.md)].
 
+## Docs for LLMs
+
+For developers working with AI and language models, we provide specialized documentation files following the [llms.txt specification](https://llmstxt.org/):
+
+- **[llms.txt](https://lingui.dev/llms.txt)** - Concise documentation optimized for LLM context windows
+- **[llms-full.txt](https://lingui.dev/llms-full.txt)** - Comprehensive documentation including all referenced URLs
+
+These files provide LLM-friendly content in a standardized format, helping language models understand and work with Lingui's documentation at inference time. The format is designed to be both human and LLM readable, with structured information that can be processed programmatically.
+
 ## License
 
 The project is licensed under the [MIT][License] license.

website/docusaurus.config.ts

@@ -144,6 +144,19 @@ const config: Config = {
             },
           ],
         },
+        {
+          title: "Docs for LLMs",
+          items: [
+            {
+              label: "llms.txt",
+              href: "https://lingui.dev/llms.txt",
+            },
+            {
+              label: "llms-full.txt",
+              href: "https://lingui.dev/llms-full.txt",
+            },
+          ],
+        },
       ],
     },
     algolia: {
@@ -190,7 +203,19 @@ const config: Config = {
       } satisfies Preset.Options,
     ],
   ],
-  plugins: ["docusaurus-plugin-sass"],
+  plugins: [
+    "docusaurus-plugin-sass",
+    [
+      "@signalwire/docusaurus-plugin-llms-txt",
+      {
+        content: {
+          enableLlmsFullTxt: true,
+          excludeRoutes: ["/", "/search", "/community", "/misc/*", "/releases/*"],
+        },
+        includeOrder: ["/installation", "/tutorials/**", "/guides/**", "/ref/**", "/examples/**"],
+      },
+    ],
+  ],
 };
 
 export default config;

website/package.json

@@ -9,7 +9,7 @@
     "swizzle": "docusaurus swizzle",
     "clear": "docusaurus clear",
     "serve": "docusaurus serve",
-    "lint": "eslint src *.js *.ts && remark . --ext md,mdx --quiet --frail --rc-path .remarkrc.mjs",
+    "lint": "eslint src *.js *.ts && remark . --ext md,mdx --quiet --frail --rc-path .remarkrc.mjs --ignore-path .gitignore",
     "lintFix": "eslint --fix src *.js *.ts",
     "checkFormat": "prettier --check .",
     "fixFormat": "prettier --write ."
@@ -20,8 +20,10 @@
     "@docusaurus/remark-plugin-npm2yarn": "3.6.3",
     "@docusaurus/theme-mermaid": "3.6.3",
     "@mdx-js/react": "3.1.0",
+    "@signalwire/docusaurus-plugin-llms-txt": "^1.2.2",
     "clsx": "2.1.1",
     "docusaurus-plugin-sass": "^0.2.6",
+    "prism-react-renderer": "^2.4.1",
     "react": "19.0.0",
     "react-dom": "19.0.0",
     "sass": "^1.83.0"