From 31010d5fc98174a0f2db106c84f8417721e0be9e Mon Sep 17 00:00:00 2001 From: Ricardo Stoklosa Date: Tue, 26 May 2026 15:08:22 -0300 Subject: [PATCH 1/3] feat: generate per-doc markdown files via docusaurus-plugin-llms Bump docusaurus-plugin-llms to 0.4.0 and enable generateMarkdownFiles so each doc page is exposed as a .md sibling. llms.txt links now point to those .md URLs (default addMdExtension behavior), which lets TagoDeploy and other consumers fetch the raw markdown for rendering. Preserves title and description front matter on generated files. --- docusaurus.config.ts | 2 ++ package-lock.json | 12 ++++++++---- package.json | 2 +- 3 files changed, 11 insertions(+), 5 deletions(-) diff --git a/docusaurus.config.ts b/docusaurus.config.ts index c9a61032..c2a8913d 100644 --- a/docusaurus.config.ts +++ b/docusaurus.config.ts @@ -110,6 +110,8 @@ const config: Config = { { generateLLMsTxt: true, generateLLMsFullTxt: true, + generateMarkdownFiles: true, + keepFrontMatter: ["title", "description"], docsDir: "docs", title: "TagoIO Docs", description: "Documentation for TagoIO IoT platform, TagoDeploy, TagoCore, TagoTiP, and the TagoIO API.", diff --git a/package-lock.json b/package-lock.json index 4c7f61eb..1748f3c9 100644 --- a/package-lock.json +++ b/package-lock.json @@ -30,7 +30,7 @@ "aws-cdk": "^2.1105.0", "aws-cdk-lib": "2.241.0", "constructs": "^10.0.0", - "docusaurus-plugin-llms": "^0.3.0", + "docusaurus-plugin-llms": "^0.4.0", "oxfmt": "^0.37.0", "oxlint": "^1.52.0", "source-map-support": "^0.5.21", @@ -12018,9 +12018,9 @@ } }, "node_modules/docusaurus-plugin-llms": { - "version": "0.3.0", - "resolved": "https://registry.npmjs.org/docusaurus-plugin-llms/-/docusaurus-plugin-llms-0.3.0.tgz", - "integrity": "sha512-JuADAJA2fjTv1U4XQUoIu1LyjISDzxFhRK5HbCZiHum4HlmdPwyx8NBXsi+LfdUyjK9acbZgazGsHPhdwEZs0g==", + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/docusaurus-plugin-llms/-/docusaurus-plugin-llms-0.4.0.tgz", + "integrity": "sha512-jYlj2HJ5+gu7oJZuJ83Hk8KlB65YlZZ/7UpHXiL7Qr+qpNBkVocmt2Molc6F3HNr5RqcfhWD/98CvgyNztg/ow==", "dev": true, "license": "MIT", "dependencies": { @@ -12031,6 +12031,10 @@ "engines": { "node": ">=18.0" }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/rachfop" + }, "peerDependencies": { "@docusaurus/core": "^3.0.0" } diff --git a/package.json b/package.json index 6da27b32..e17213be 100644 --- a/package.json +++ b/package.json @@ -50,7 +50,7 @@ "aws-cdk": "^2.1105.0", "aws-cdk-lib": "2.241.0", "constructs": "^10.0.0", - "docusaurus-plugin-llms": "^0.3.0", + "docusaurus-plugin-llms": "^0.4.0", "oxfmt": "^0.37.0", "oxlint": "^1.52.0", "source-map-support": "^0.5.21", From 57e6692fbf4f682d8b2942924bfd202130874ce2 Mon Sep 17 00:00:00 2001 From: Ricardo Stoklosa Date: Fri, 29 May 2026 14:21:36 -0300 Subject: [PATCH 2/3] refactor: drop keepFrontMatter from llms plugin config --- docusaurus.config.ts | 1 - 1 file changed, 1 deletion(-) diff --git a/docusaurus.config.ts b/docusaurus.config.ts index a79a8b4e..20acd3a6 100644 --- a/docusaurus.config.ts +++ b/docusaurus.config.ts @@ -111,7 +111,6 @@ const config: Config = { generateLLMsTxt: true, generateLLMsFullTxt: true, generateMarkdownFiles: true, - keepFrontMatter: ["title", "description"], docsDir: "docs", title: "TagoIO Docs", description: "Documentation for TagoIO IoT platform, TagoDeploy, TagoCore, TagoTiP, and the TagoIO API.", From 7d7a11520c007fa56b9f5c024a4b1921bd54efbe Mon Sep 17 00:00:00 2001 From: Ricardo Stoklosa Date: Fri, 29 May 2026 14:36:18 -0300 Subject: [PATCH 3/3] revert: restore keepFrontMatter in llms plugin config --- docusaurus.config.ts | 1 + 1 file changed, 1 insertion(+) diff --git a/docusaurus.config.ts b/docusaurus.config.ts index 20acd3a6..a79a8b4e 100644 --- a/docusaurus.config.ts +++ b/docusaurus.config.ts @@ -111,6 +111,7 @@ const config: Config = { generateLLMsTxt: true, generateLLMsFullTxt: true, generateMarkdownFiles: true, + keepFrontMatter: ["title", "description"], docsDir: "docs", title: "TagoIO Docs", description: "Documentation for TagoIO IoT platform, TagoDeploy, TagoCore, TagoTiP, and the TagoIO API.",