Update content

Author: brunopgalvao

.CONTRIBUTING.md

@@ -46,6 +46,7 @@ For simple contributions like fixing typos or making small text changes, you can
    - Fork the repository to your account.
    - Create a branch with your changes.
    - Open a pull request.
+      - Make sure to check "Allow edits from maintainers"
 
 ## Fork and Edit Locally
 
@@ -113,8 +114,6 @@ Making changes to existing pages is the simplest contribution:
 2. **Follow page requirements**: Ensure your changes maintain proper formatting.
 3. **Test locally**: Verify your changes render correctly.
 
-**No additional files need updating** when you're only modifying existing content.
-
 ## Add a New Page
 
 **Requirement**: Follow the [PaperMoon Documentation Style Guide](https://github.com/papermoonio/documentation-style-guide).
@@ -129,6 +128,7 @@ To add a page to an existing section:
    ---
    title: Page Title (max 60 chars for SEO)
    description: Description for SEO (120-160 chars)
+   categories: Category1, Category2
    ---
 
    # Page Title
@@ -142,6 +142,12 @@ To add a page to an existing section:
    List any required tools, knowledge, or setup.
    ```
 
+   **Categories**
+
+   Available categories for pages are found in [scripts/llms_config.json](./scripts/llms_config.json).
+
+   **Search Engine Optimization (SEO)**
+
    Resources for good SEO:
    - [Google's title recommendations](https://developers.google.com/search/docs/advanced/appearance/title-link?hl=en)
    - [Google's description recommendations](https://developers.google.com/search/docs/advanced/appearance/snippet?hl=en)
@@ -180,7 +186,14 @@ To create an entirely new section of documentation:
    - Files: `'Display Name': 'file-name.md'`
    - Subdirectories: Listed by directory name
 
-3. **Create `index.md`** - Landing page with frontmatter and content introducing the section
+3. Create the `index.md` landing page with frontmatter and content introducing the section.
+   
+   - In the `index.md` add the following snippet to display what content is available in the section:
+   ```markdown
+   ## In This Section
+
+   :::INSERT_IN_THIS_SECTION:::
+   ```
 
 ## Write a Tutorial
 
@@ -239,10 +252,6 @@ How to confirm it worked
 Related tutorials
 ```
 
-### Tutorial Categories
-
-Available categories for tutorials are found in [scripts/llms_config.json](./scripts/llms_config.json).
-
 ### Tutorial Requirements
 
 - All code examples must be tested and functional.

llms.txt

@@ -88,7 +88,7 @@
 - [Storage](https://raw.githubusercontent.com/polkadot-developers/polkadot-docs/refs/heads/master/develop/toolkit/integrations/storage.md): Explore decentralized storage solutions for your Polkadot dApp. Discover key integrations, such as Crust and IPFS, for robust, censorship-resistant data storage.
 - [Transaction Construction](https://raw.githubusercontent.com/polkadot-developers/polkadot-docs/refs/heads/master/develop/toolkit/integrations/transaction-construction.md): Understand how to construct, sign, and broadcast transactions in the Polkadot ecosystem using various tools and libraries.
 - [Wallets](https://raw.githubusercontent.com/polkadot-developers/polkadot-docs/refs/heads/master/develop/toolkit/integrations/wallets.md): Explore blockchain wallets. Securely manage digital assets with hot wallets for online access or cold wallets for offline, enhanced security.
-- [Interoperability](https://raw.githubusercontent.com/polkadot-developers/polkadot-docs/refs/heads/master/develop/toolkit/interoperability/index.md): Explore Polkadot's XCM tooling ecosystem, featuring the Asset Transfer API and other utilities for implementing cross-chain messaging and transfers.
+- [Interoperability](https://raw.githubusercontent.com/polkadot-developers/polkadot-docs/refs/heads/master/develop/toolkit/interoperability/index.md): Explore Polkadot's XCM tooling ecosystem, featuring utilities for implementing cross-chain messaging and transfers.
 - [ParaSpell XCM SDK](https://raw.githubusercontent.com/polkadot-developers/polkadot-docs/refs/heads/master/develop/toolkit/interoperability/paraspell-xcm-sdk/index.md): A powerful open-source library that simplifies XCM integration, enabling developers to easily build interoperable dApps on Polkadot.
 - [XCM Tools](https://raw.githubusercontent.com/polkadot-developers/polkadot-docs/refs/heads/master/develop/toolkit/interoperability/xcm-tools.md): Explore essential XCM tools across Polkadot, crafted to enhance cross-chain functionality and integration within the ecosystem.
 - [E2E Testing on Polkadot SDK Chains](https://raw.githubusercontent.com/polkadot-developers/polkadot-docs/refs/heads/master/develop/toolkit/parachains/e2e-testing/index.md): Discover a suite of tools for E2E testing on Polkadot SDK-based blockchains, including configuration management, automation, and debugging utilities.