Frontmatter changes to support auto-generated index page tables

chain-interactions/accounts/create-account.md

@@ -1,6 +1,7 @@
 ---
 title: Create an Account
 description: Step-by-step guide to creating Polkadot accounts using different programming languages and libraries, including JavaScript, Python, and Rust examples.
+short_description: Generate accounts using various SDKs in Rust, Python, and JavaScript.
 categories: Basics, Chain Interactions
 page_badges:
   tutorial_badge: Beginner

chain-interactions/accounts/query-accounts.md

@@ -1,6 +1,7 @@
 ---
 title: Query Account Information with SDKs
 description: Learn how to query account information using five popular SDKs—Polkadot API (PAPI), Polkadot.js API, Dedot, Python Substrate Interface, and Subxt.
+short_description: Retrieve account information including balances, nonces, and metadata.
 categories: Chain Interactions, Tooling
 page_badges:
   tutorial_badge: Beginner

chain-interactions/index.md

@@ -26,69 +26,68 @@ Whether you're building a frontend application, a backend service, or integratin
 
 Accessing blockchain state is fundamental to building responsive applications. Polkadot offers several methods to query on-chain data, each suited for different use cases.
 
-- **[SDK integration](/chain-interactions/query-data/query-sdks/)**: Programmatically read blockchain state using:
-
-    - [Polkadot API (PAPI)](/reference/tools/papi/)
-    - [Polkadot.js](/reference/tools/polkadot-js-api/)
-    - [Dedot](/reference/tools/dedot/)
-    - [Python Substrate Interface](/reference/tools/py-substrate-interface/)
-    - [Subxt](/reference/tools/subxt/)
-
-- **[REST API access](/chain-interactions/query-data/query-rest/)**: Query chain data through standardized REST endpoints for simpler integration.
-- **[Runtime API calls](/chain-interactions/query-data/runtime-api-calls/)**: Execute runtime APIs directly for specialized queries and operations.
+<!-- INDEX TABLE START
+dir: query-data
+flat: true
+columns: [title, description]
+-->
+<!-- INDEX TABLE END -->
 
 ### Send Transactions
 
 Transactions are the primary mechanism for modifying blockchain state. Understanding transaction construction, signing, and submission is crucial for building interactive applications.
 
-- **[Transaction construction](/chain-interactions/send-transactions/with-sdks/)**: Build transactions using various SDKs with proper encoding and formatting.
-- **[Fee estimation](/chain-interactions/send-transactions/calculate-transaction-fees/)**: Calculate transaction fees to ensure sufficient balance and optimize costs.
-- **[Multi-token fees](/chain-interactions/send-transactions/pay-fees-with-different-tokens/)**: Learn how to pay transaction fees with different tokens on supported chains.
+<!-- INDEX TABLE START
+dir: send-transactions
+flat: true
+columns: [title, description]
+-->
+<!-- INDEX TABLE END -->
 
 ### Send Cross-Chain Transactions
 
 Polkadot enables native cross-chain capabilities through Cross-Consensus Messaging (XCM), allowing chains to securely communicate and transfer assets across the ecosystem.
 
-- **[Transfer assets between parachains](/chain-interactions/send-transactions/interoperability/transfer-assets-parachains/)**: Understand how to construct and send XCM messages using [ParaSpell XCM SDK](/reference/tools/paraspell/) and [Polkadot API (PAPI)](/reference/tools/papi/).
-- **[Transfer assets into Polkadot](/chain-interactions/send-transactions/interoperability/transfer-assets-into-polkadot/)**: A step-by-step guide to bridging assets from Ethereum to Polkadot using the [ParaSpell XCM SDK](/reference/tools/paraspell/) and [Snowbridge](https://wiki.polkadot.com/learn/learn-snowbridge/){target=\_blank}.
+<!-- INDEX TABLE START
+dir: send-transactions/interoperability
+flat: true
+columns: [title, description]
+-->
+<!-- INDEX TABLE END -->
 
 ### Manage Tokens
 
 Polkadot Hub provides a unified platform for managing assets across the ecosystem. Understanding token operations is essential for DeFi applications and multi-chain asset management.
 
-- **[Local asset registration](/chain-interactions/token-operations/register-local-asset/)**: Learn how assets created in Asset Hub are registered on the network.
-- **[Foregin asset registration](/chain-interactions/token-operations/register-foreign-asset/)**: Learn how assets created outside of Asset Hub are registered on the network.
-- **[Convert assets](/chain-interactions/token-operations/convert-assets/)**: Convert, swap, and manage assets on-chain using the Asset Conversion pallet.
-- **Asset Hub integration**: Interact with Polkadot's central asset management hub using [Polkadot.js Apps](https://polkadot.js.org/apps/){target=\_blank}.
+<!-- INDEX TABLE START
+dir: token-operations
+flat: true
+columns: [title, description]
+-->
+<!-- INDEX TABLE END -->
 
 ### Manage Accounts
 
 Account management forms the basis of user identity and authentication in blockchain applications. Learn how to create, manage, and query accounts programmatically.
 
-- **[Account creation](/chain-interactions/accounts/create-account/)**: Generate accounts using various SDKs in Rust, Python, and JavaScript.
-- **[Account queries](/chain-interactions/accounts/query-accounts/)**: Retrieve account information including balances, nonces, and metadata.
+<!-- INDEX TABLE START
+dir: accounts
+flat: true
+columns: [title, description]
+-->
+<!-- INDEX TABLE END -->
 
 ## Development Tools and SDKs
 
 The Polkadot ecosystem offers a rich set of tools and libraries to facilitate chain interactions:
 
-- **[Polkadot API (PAPI)](/reference/tools/papi/)**: Modern, type-safe TypeScript library with full metadata support.
-- **[Polkadot.js](/reference/tools/polkadot-js-api/)**: Comprehensive JavaScript library with extensive ecosystem support.
-- **[Dedot](/reference/tools/dedot/)**: Lightweight TypeScript library optimized for performance.
-- **[Python Substrate Interface](/reference/tools/py-substrate-interface/)**: Polkadot Substrate Interface for streamlined development.
-- **[Subxt](/reference/tools/subxt/)**: Rust library for building robust substrate-based applications.
-- **[Polkadot.js Apps](https://polkadot.js.org/apps/)**: Web-based interface for exploring and interacting with chains.
+| Tool | Description |
+|------|-------------|
+| [Polkadot API (PAPI)](/reference/tools/papi/) | Modern, type-safe TypeScript library with full metadata support. |
+| [Polkadot.js](/reference/tools/polkadot-js-api/) | Comprehensive JavaScript library with extensive ecosystem support. |
+| [Dedot](/reference/tools/dedot/) | Lightweight TypeScript library optimized for performance. |
+| [Python Substrate Interface](/reference/tools/py-substrate-interface/) | Polkadot Substrate Interface for streamlined development. |
+| [Subxt](/reference/tools/subxt/) | Rust library for building robust substrate-based applications. |
+| [Polkadot.js Apps](https://polkadot.js.org/apps/) | Web-based interface for exploring and interacting with chains. |
 
 Each tool has its strengths, and choosing the right one depends on your project requirements, programming language preference, and specific use cases.
-
-## Next Steps
-
-Explore the sections below to dive deeper into specific chain interaction patterns:
-
-- **[Query On-Chain Data](/chain-interactions/query-data/query-sdks/)**: Learn to read blockchain state efficiently.
-- **[Send Transactions](/chain-interactions/send-transactions/with-sdks/)**: Master transaction construction and submission.
-- **[Send Cross-Chain Transactions](/chain-interactions/send-transactions/interoperability/transfer-assets-parachains/)**: Enable cross-chain communication with XCM.
-- **[Manage Tokens](/chain-interactions/token-operations/register-local-asset/)**: Manage assets across the Polkadot ecosystem.
-- **[Manage Accounts](/chain-interactions/accounts/create-account/)**: Create and query accounts programmatically.
-
-Each section provides practical examples, code snippets, and comprehensive guides to help you build production-ready applications on Polkadot.

chain-interactions/query-data/query-rest.md

@@ -1,6 +1,7 @@
 ---
 title: Query On-Chain State with Sidecar REST API
 description: Learn how to query on-chain state on Polkadot using the Sidecar REST API with curl, including account balances, asset data, and block information.
+short_description: Query chain data through standardized REST endpoints for simpler integration.
 categories: Chain Interactions, Tooling
 ---
 

chain-interactions/query-data/query-sdks.md

@@ -1,6 +1,7 @@
 ---
 title: Query On-Chain State with SDKs
 description: Learn how to query on-chain storage data on Polkadot Hub using PAPI, Polkadot.js, Dedot, Python Substrate Interface, and Subxt.
+short_description: Programmatically read blockchain state using PAPI, Polkadot.js, Dedot, Python Substrate Interface, and Subxt.
 categories: Chain Interactions, Tooling
 page_badges:
   tutorial_badge: Intermediate

chain-interactions/query-data/runtime-api-calls.md

@@ -1,6 +1,7 @@
 ---
 title: Runtime API Calls
 description: Learn how to call Polkadot runtime APIs to access the Wasm runtime and retrieve computed results using PAPI, Polkadot.js, Dedot, Python, and Subxt.
+short_description: Execute runtime APIs directly for specialized queries and operations.
 categories: Polkadot Protocol, Tooling
 ---
 

chain-interactions/send-transactions/calculate-transaction-fees.md

@@ -1,6 +1,7 @@
 ---
 title: Calculate Transaction Fees
 description: Learn how to calculate transaction fees on Polkadot using Polkadot-API, Polkadot.js API, and the Polkadot.js Apps UI to estimate transfer costs.
+short_description: Calculate transaction fees to ensure sufficient balance and optimize costs.
 categories: Chain Interactions, Tooling
 page_badges:
   tutorial_badge: Beginner

chain-interactions/send-transactions/interoperability/debug-and-preview-xcms.md

@@ -1,6 +1,7 @@
 ---
 title: Replay and Dry Run XCMs
 description: Replay and dry-run XCMs using Chopsticks with full logging enabled. Diagnose issues, trace message flow, and debug complex cross-chain interactions.
+short_description: Replay and dry-run XCMs using Chopsticks to diagnose issues and debug cross-chain interactions.
 categories: Interoperability, Tooling
 page_badges:
   tutorial_badge: Advanced

chain-interactions/send-transactions/interoperability/estimate-xcm-fees.md

@@ -1,6 +1,7 @@
 ---
 title: XCM Fee Estimation
 description: This tutorial demonstrates how to estimate the fees for teleporting assets from the Polkadot Hub TestNet to the Paseo People Chain.
+short_description: Estimate fees for teleporting assets between chains on the Polkadot network.
 categories: Interoperability, Chain Interactions
 page_badges:
   tutorial_badge: Intermediate

chain-interactions/send-transactions/interoperability/transfer-assets-into-polkadot.md

@@ -1,6 +1,7 @@
 ---
 title: Transfer Assets from Ethereum into Polkadot
 description: A step-by-step guide to bridging assets from Ethereum to Polkadot using the ParaSpell XCM SDK and Snowbridge.
+short_description: Bridge assets from Ethereum to Polkadot using the ParaSpell XCM SDK and Snowbridge.
 categories: Interoperability
 ---
 

chain-interactions/send-transactions/interoperability/transfer-assets-parachains.md

@@ -1,6 +1,7 @@
 ---
 title: Transfer Assets Between Parachains
 description: A step-by-step guide to using the ParaSpell XCM SDK to build, verify, and execute a transfer from one Parachain to another.
+short_description: Construct and send XCM messages using ParaSpell XCM SDK and Polkadot API (PAPI).
 categories: Interoperability, Parachains
 page_badges:
   tutorial_badge: Intermediate

chain-interactions/send-transactions/pay-fees-with-different-tokens.md

@@ -1,6 +1,7 @@
 ---
 title: Pay Transaction Fees with Different Tokens
 description: Learn how to send a DOT transfer transaction while paying the fees using a different token on Polkadot Hub using multiple SDKs.
+short_description: Pay transaction fees with different tokens on supported chains.
 categories: Chain Interactions, Tooling
 page_badges:
   tutorial_badge: Intermediate

chain-interactions/send-transactions/with-sdks.md

@@ -1,6 +1,7 @@
 ---
 title: Send Transactions with SDKs
 description: Learn how to construct, sign, and submit transactions using PAPI, Polkadot.js, Dedot, Python Substrate Interface, and Subxt.
+short_description: Build transactions using various SDKs with proper encoding and formatting.
 categories: Chain Interactions, Tooling
 page_badges:
   tutorial_badge: Intermediate

chain-interactions/token-operations/convert-assets.md

@@ -1,6 +1,7 @@
 ---
 title: Convert Assets on Asset Hub
 description: A guide detailing the step-by-step process of converting assets on Asset Hub, helping users efficiently navigate asset management on the platform.
+short_description: Convert, swap, and manage assets on-chain using the Asset Conversion pallet.
 categories: Chain Interactions, Tooling
 page_badges:
   tutorial_badge: Intermediate

chain-interactions/token-operations/register-foreign-asset.md

@@ -1,6 +1,7 @@
 ---
 title: Register a Foreign Asset
 description: Learn step-by-step how to register a foreign asset on Polkadot Hub and the origin parachain to enable cross-chain token transfers.
+short_description: Register assets created outside of Asset Hub on Polkadot Hub.
 categories: Interoperability, Parachains
 page_badges:
   tutorial_badge: Intermediate

chain-interactions/token-operations/register-local-asset.md

@@ -1,6 +1,7 @@
 ---
 title: Register a Local Asset
 description: Learn how to register a local asset on Polkadot Hub, including prerequisites, deposits, and step-by-step instructions using Polkadot.js Apps.
+short_description: Register assets created in Asset Hub on Polkadot Hub.
 categories: Basics, Chain Interactions
 page_badges:
   tutorial_badge: Beginner

parachains/customize-runtime/add-existing-pallets.md

@@ -1,6 +1,7 @@
 ---
 title: Add an Existing Pallet to the Runtime
 description: Learn how to include and configure pallets in a Polkadot SDK-based runtime, from adding dependencies to implementing necessary traits.
+short_description: Integrate pre-built pallets from the FRAME ecosystem.
 categories: Parachains
 page_badges:
   tutorial_badge: Intermediate

parachains/customize-runtime/add-pallet-instances.md

@@ -1,6 +1,7 @@
 ---
 title: Add Multiple Pallet Instances
 description: Learn how to implement multiple instances of the same pallet in your Polkadot SDK-based runtime, from adding dependencies to configuring unique instances.
+short_description: Configure and use multiple instances of the same pallet.
 categories: Parachains
 page_badges:
   tutorial_badge: Intermediate

parachains/customize-runtime/add-smart-contract-functionality.md

@@ -1,6 +1,7 @@
 ---
 title: Add Smart Contract Functionality
 description: Add smart contract capabilities to your Polkadot SDK-based blockchain. Explore PVM, EVM, and Wasm integration for enhanced chain functionality.
+short_description: Enable smart contract capabilities using Contracts or EVM pallets.
 categories: Parachains
 ---
 

parachains/customize-runtime/pallet-development/benchmark-pallet.md

@@ -1,6 +1,7 @@
 ---
 title: Benchmark Your Pallet
 description: Learn how to benchmark extrinsics in your custom pallet to generate precise weight calculations suitable for production use.
+short_description: Measure and optimize pallet performance with benchmarking.
 categories: Parachains
 page_badges:
   tutorial_badge: Advanced

parachains/customize-runtime/pallet-development/create-a-pallet.md

@@ -1,6 +1,7 @@
 ---
 title: Create a Custom Pallet
 description: Learn how to create custom pallets using FRAME, allowing for flexible, modular, and scalable blockchain development. Follow the step-by-step guide.
+short_description: Build a pallet from scratch with custom logic.
 categories: Parachains
 page_badges:
   tutorial_badge: Beginner

parachains/customize-runtime/pallet-development/mock-runtime.md

@@ -1,6 +1,7 @@
 ---
 title: Mock Your Runtime
 description: Learn how to create a mock runtime environment for testing your custom pallets in isolation, enabling comprehensive unit testing before runtime integration.
+short_description: Set up a mock runtime environment for testing.
 categories: Parachains
 page_badges:
   tutorial_badge: Intermediate

parachains/customize-runtime/pallet-development/pallet-testing.md

@@ -1,6 +1,7 @@
 ---
 title: Unit Test Pallets
 description: Learn how to efficiently test pallets in the Polkadot SDK, ensuring the reliability and security of your pallets operations.
+short_description: Write comprehensive tests for your pallet logic.
 categories: Parachains
 page_badges:
   tutorial_badge: Intermediate