Skip to content

Audit and update categories for file bundles#246

Open
dawnkelly09 wants to merge 2 commits intomainfrom
dk/category-audit
Open

Audit and update categories for file bundles#246
dawnkelly09 wants to merge 2 commits intomainfrom
dk/category-audit

Conversation

@dawnkelly09
Copy link
Contributor

@dawnkelly09 dawnkelly09 commented Mar 9, 2026

Needs polkadot-docs PR: polkadot-developers/polkadot-docs#1547

Nico and Bruno: please take a look at the categories and descriptions and let me know what you think. If we want to make changes here, we just need to make sure the other PR gets updated as well (tags on pages). Thank you!

This pull request updates the llms_config.json file to expand and clarify the descriptions for the Polkadot knowledge base categories. It also restructures some categories for better coverage and introduces new ones to provide more targeted guidance for developers.

Category and description updates:

Expanded and clarified category descriptions:

  • Updated the descriptions for basics, smart_contracts, parachains, infrastructure, tooling, and reference to be more comprehensive and specific about the content covered in each knowledge base section.

Category restructuring and additions:

  • Removed the chain_interactions, dapps, and networks categories, and replaced them with new categories: accounts_and_transactions and interoperability, each with detailed descriptions of their focus areas.
  • Reintroduced and expanded the polkadot_protocol category, now with a more in-depth technical description.

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the Polkadot LLM knowledge-base category configuration (llms_config.json) by expanding category descriptions, restructuring categories for clearer coverage, and introducing new categories to better guide developer-facing content classification.

Changes:

  • Expanded and clarified descriptions for existing categories (e.g., basics, smart_contracts, parachains, infrastructure, tooling, reference).
  • Replaced chain_interactions, dapps, and networks with accounts_and_transactions and interoperability.
  • Reintroduced/expanded polkadot_protocol with a more detailed technical scope.

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

@dawnkelly09
Copy link
Contributor Author

Descriptions shortened, change of "chain_interactions" for "accounts_and_transaction" rolled back, pages retagged on the docs PR. 🫡

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants