Makes needed updates to LLM file generation to integrate resolve_md #1374

dawnkelly09 · 2026-01-21T20:30:06Z

Goes with mkdocs PR: papermoonio/moonbeam-mkdocs#298

Description

Please explain the changes this PR addresses here.

Checklist

[ x] Added a label 🏷️ to this PR
[ x] Ran my changes through Grammarly
[n/a ] Added a disclaimer if required
[ n/a ] If pages were moved, opened a corresponding PR in moonbeam-mkdocs to update redirects

Translations

Does this PR update a page that also exists on the Chinese docs site? See mapping to confirm.

Yes
[x ] No

This pull request updates the AI resources documentation and related assets to improve clarity, add new AI resource formats, and clean up outdated code and workflows. The most significant changes include a major overhaul of the AI resource download table, addition of new JSON-based resource formats, and removal of obsolete scripts and CI validation.

Documentation and Resource Table Improvements:

The AI resources table in ai-resources/ai-resources.md has been completely revamped for clarity and usability. It now features improved descriptions, new file formats (including JSON and JSONL), and enhanced download/copy/view actions for each resource.
Added new resource formats: a lightweight site index in JSON (site-index.json) and full documentation content in JSONL (llms-full.jsonl), making it easier to consume documentation for AI and LLM applications.
Updated the note to reference the new llms-full.jsonl file instead of the old llms-full.txt.

Code and Workflow Cleanup:

Removed the js/clipboardCopyllms.js script, which previously handled copying the full LLM resource to the clipboard, as the new table provides built-in copy actions.
Deleted the .github/workflows/check-llms.yml workflow, which validated the old llms-full.txt format, as it is now obsolete with the new resource formats.

…lugin

Copilot

Pull request overview

This pull request updates the AI resources documentation infrastructure by replacing the Python-based LLM file generation system with a new approach using the MkDocs resolve_md plugin. The changes include removing legacy scripts, workflows, and handlers, while introducing a new JavaScript-based UI for per-page LLM functionality and updating the AI resources table with new file formats.

Changes:

Removed legacy Python scripts for LLM file generation and the associated GitHub workflow validation
Added new JavaScript functionality for per-page copy-to-LLM operations with ChatGPT and Claude integration
Updated AI resources table to reflect new file formats (JSON, JSONL, Markdown) and locations, with improved UI for view/copy/download actions

Reviewed changes

Copilot reviewed 9 out of 30 changed files in this pull request and generated 20 comments.

Show a summary per file

File	Description
`scripts/llms_config.json`	Removed legacy configuration file for Python-based LLM generation
`scripts/generate_llms_standard.py`	Removed legacy Python script for standard LLM file generation
`scripts/generate_llms_by_category.py`	Removed legacy Python script for category-based LLM file generation
`scripts/generate_llms.py`	Removed legacy main Python entry point for LLM generation
`llms.txt`	Removed legacy generated navigation index file
`js/clipboardCopyllms.js`	Removed old clipboard copy handler for full LLM resource
`.github/workflows/check-llms.yml`	Removed obsolete validation workflow for legacy txt format
`js/copy-to-llms.js`	Added new UI controller for per-page LLM operations with copy/download/view/ChatGPT/Claude functionality
`ai-resources/ai-resources.md`	Updated documentation table with new resource formats, file locations, and action buttons

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

ai-resources/ai-resources.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot

Pull request overview

Copilot reviewed 9 out of 30 changed files in this pull request and generated 4 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

ai-resources/ai-resources.md

js/copy-to-llms.js

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

ai-resources/ai-resources.md

dawnkelly09 · 2026-01-27T19:31:15Z

Draft mode pending Rose deployment. Currently, the per-page widget renders on the Chinese site pages but, we don't have support for generating the needed files in Chinese in order to serve them to users.

eshaben

I also think we should ignore index pages for Moonbeam, since those pages are primarily navigational and don’t provide meaningful content that would be useful to provide to LLMs.

eshaben · 2026-01-29T02:45:27Z

js/copy-to-llms.js

+  function getScopeUrl() {
+    try {
+      const scope = window.__md_scope;
+      if (scope instanceof URL) {
+        return scope;
+      }
+      return new URL('.', window.location);
+    } catch (error) {
+      return null;
+    }


This is reintroducing the window.__md_scope, which you know what I'm going to say haha...

I think you probably just copied this from wormhole, must have been a timing thing cause this was fixed in the polkadot changes. So this whole function and the whole stripBasePath functions aren't really necessary.

This is the last commit on the Polkadot repo before the toggle page changes and it doesn't have any of this: https://github.com/polkadot-developers/polkadot-docs/blob/c74677e2438c61ba30c96334b6c84fd964bb3268/js/copy-to-llm.js

Just wanted to flag this, but no need to fix it now since you'll be working on the plugin, it can be all addressed then.

eshaben · 2026-01-29T03:12:07Z

js/copy-to-llms.js

+  function initialize() {
+    addSectionCopyButtons();
+  }


The 404 changes didn't get carried over. We should def add that

Makes needed updates to LLM file generation to integrate resolve_md p…

dfa5a9a

…lugin

dawnkelly09 added A1 - Maintenance Major Pull request contains major updates to an existing page (i.e., adding a new section, reorgs, etc.) B0 - Needs Review Pull request is ready for review labels Jan 21, 2026

dawnkelly09 temporarily deployed to n8n-sending January 21, 2026 20:30 — with GitHub Actions Inactive

dawnkelly09 temporarily deployed to n8n-receiving January 21, 2026 20:31 — with GitHub Actions Inactive

dawnkelly09 mentioned this pull request Jan 21, 2026

Makes changes needed to update LLM generation and use resolve_md plugin papermoonio/moonbeam-mkdocs#298

Draft

dawnkelly09 marked this pull request as ready for review January 21, 2026 20:38

dawnkelly09 requested a review from a team as a code owner January 21, 2026 20:38

Copilot AI review requested due to automatic review settings January 21, 2026 20:38

Copilot started reviewing on behalf of dawnkelly09 January 21, 2026 20:38 View session

Copilot AI reviewed Jan 21, 2026

View reviewed changes

dawnkelly09 and others added 3 commits January 21, 2026 14:02

Update ai-resources/ai-resources.md

7e3b15e

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Update ai-resources/ai-resources.md

946563b

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

table fixes

67497be

dawnkelly09 requested a review from Copilot January 21, 2026 22:08

Copilot started reviewing on behalf of dawnkelly09 January 21, 2026 22:09 View session

Copilot AI reviewed Jan 21, 2026

View reviewed changes

ai-resources/ai-resources.md Outdated Show resolved Hide resolved

js/copy-to-llms.js Outdated Show resolved Hide resolved

js/copy-to-llms.js Outdated Show resolved Hide resolved

js/copy-to-llms.js Show resolved Hide resolved

Update ai-resources/ai-resources.md

15e1465

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

themacexpert requested changes Jan 21, 2026

View reviewed changes

ai-resources/ai-resources.md Outdated Show resolved Hide resolved

themacexpert reviewed Jan 21, 2026

View reviewed changes

ai-resources/ai-resources.md Outdated Show resolved Hide resolved

dawnkelly09 added 3 commits January 26, 2026 09:18

adds noopener to chatgpt and claude window.open

acd9f94

patches to view functionality

36b6dd1

Merge remote-tracking branch 'origin' into support-resolvemd-plugin

49c4971

dawnkelly09 requested a review from themacexpert January 26, 2026 17:48

dawnkelly09 added 2 commits January 27, 2026 10:58

Merge remote-tracking branch 'origin' into support-resolvemd-plugin

3b0cde9

remove view for llms-full.jsonl

8207384

dawnkelly09 marked this pull request as draft January 27, 2026 19:30

eshaben reviewed Jan 29, 2026

View reviewed changes

Makes needed updates to LLM file generation to integrate resolve_md #1374

Are you sure you want to change the base?

Makes needed updates to LLM file generation to integrate resolve_md #1374

Uh oh!

Conversation

dawnkelly09 commented Jan 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Checklist

Translations

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

dawnkelly09 commented Jan 27, 2026

Uh oh!

eshaben left a comment

Choose a reason for hiding this comment

Uh oh!

eshaben Jan 29, 2026

Choose a reason for hiding this comment

Uh oh!

eshaben Jan 29, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

dawnkelly09 commented Jan 21, 2026 •

edited

Loading