stack-directory-metakeywords

keywords.config.yaml

@@ -1,3 +1,6 @@
+---
+# Keywords config file
+
 # Metadata Configuration for Documentation
 metadata_rules:
   # PERSONA
@@ -49,7 +52,7 @@ metadata_rules:
     required: true
     multiple: true
     min: 1
-    max: 5
+    max: 8
     validation_rules:
       - no_duplicates: true
         description: "Categories must not repeat"
@@ -62,19 +65,47 @@ metadata_rules:
       - alt-da              
       - permissionless-batch-submission
       - block-times
-
+      - data-availability
+      - data-availability-layer
+      - blob-configuration
+
       # Sequencing Layer
       - sequencer
       - sequencer-pbs
       - sequencer-decentralization
       - sequencer-in-a-box
       - op-batcher
+      - batcher-configuration
+      - outages
+      - downtime
+      - optimism-portal
+      - transaction-submission
+      - transaction-inclusion
+      - censorship-resistance
+      - disaster-recovery
+      - forced-transactions
+      - sequencing-layer
 
       # Derivation Layer
-      - rollup-node        
+      - rollup-node
+      - rollup-configuration
+      - consensus-client
+      - op-node        
       - fault-proofs
       - fp-contracts
+      - dispute-game
+      - dispute-resolution
+      - fault-tolerance
+      - fault-proof-system
+      - contests
+      - span-batches
+      - virtual-machine
       - op-challenger
+      - safe-head
+      - derivation
+      - derivation-pipeline
+      - derivation-layer
+      - batch-submission
       - cannon
       - zk
       - op-workbench       # Tool: derivation testing & simulation
@@ -90,39 +121,134 @@ metadata_rules:
       - preinstalls
       - custom-gas-token
       - gas
+      - gas-configuration
+      - fee-optimization
+      - node-configuration
+      - gas-optimization
+      - rpc
+      - mempool
+      - block-production
+      - block-execution
       - transactions
+      - conditional-transactions
       - l2-contracts
+      - transaction-management
       - account-abstraction
       - paymasters
+      - l1-data-fee
+      - execution-gas-fee
+      - execution-client
+      - eip-1559
+      - sequencer-fee-vault
       - dev-console        # Tool: execution layer interaction
-
+      - execution-layer
+
       # Settlement Layer
       - l1-contracts
+      - superchain-contracts
+      - op-contracts
       - standard-bridge
+      - custom-bridge
       - superchain-erc20
+      - deposits
+      - proxy
+      - withdrawals
       - teleportr
+      - bridging
+      - token-standard
+      - token-bridge
+      - eth-bridging
+      - superchain-weth
+      - superchain-token-bridge
+      - token-deployment
+      - event-reading
+      - block-safety
+      - dependency-set  
       - interoperability
       - cross-chain-messaging
+      - cross-domain-messenger
+      - message-relaying
+      - message-passing
+      - message-validation
+      - transaction-flow
+      - l1-l2-communication
+      - l2-output-submission
+      - message-proving
+      - message-finalization
+      - l2-to-l1
+      - token-transfers
       - interoperable-assets
+      - reorgs
       - op-deployer        # Tool: contract deployment
       - op-supervisor
+      - transaction-finality
+      - ethereum-consensus
+      - finality-guarantees
+      - transaction-lifecycle
+      - rollup-transactions
+      - state-commitment
+      - contract-addresses
+      - settlement-layer
+      - proposer-configuration
 
       # Governance Layer
       - security-council
+      - guardian
+      - multisig
+      - governance
+      - optimism-collective
+      - superchain-ecosystem
+      - token-house
+      - citizens-house
+      - delegates
+      - voting
+      - audits
+      - privileged-roles
+      - security-policy
+      - security-model
+      - security-reviews
+      - vulnerability-assessment
+      - bug-bounty-program
+      - responsible-disclosure
+      - vulnerability-reporting
+      - safety-mechanisms
+      - pause
+      - emergency-response
       - op-token
       - blockspace-charters
       - retro-funding
       - revshare-enshrinement
+      - superchain
       - superchain-registry
+      - contract-upgrades
+      - governance-layer
 
       # Cross-layer Development Tools
+      - architecture
+      - op-stack
       - supersim            # Tests across multiple layers
-      - devnets            # Full-stack local environment
+      - devnet            # Full-stack local environment
       - performance-tooling # Stack-wide performance testing
-      - superchain-registry # Chain management across layers
       - l1-deployment-upgrade-tooling  # Cross-layer deployment
       - l2-deployment-upgrade-tooling  # Cross-layer deployment
       - testnet-tooling # testnet-specific tools like faucets, block explorers, etc
+      - deployment-tooling # deployment-specific tools like OPCM
+      - testing-environment
+      - testing
+      - alphanets
+      - betanets
+      - l2-rollup
+      - chain-deployment
+      - layer2-scaling
+      - system-components
+      - smart-contracts
+      - deployment-artifacts
+      - local-development-environment
+      - genesis-configuration
+      - genesis-creation
+      - chain-configuration
+      - kurtosis
+      - docker
 
       # Chain Management (Cross-layer)
       - protocol
@@ -139,6 +265,7 @@ metadata_rules:
       - dispute-mon
       - monitorism
       - vertical-scaling
+      - chain-operation
 
       # Protocol Releases
       - granite
@@ -150,21 +277,37 @@ metadata_rules:
       - fjord
       - network-upgrade
       - hard-fork
+      - hardfork-activation
+      - protocol-upgrades
 
       # Infrastructure & Operations
       - kubernetes-infrastructure
       - devops-tooling
       - artifacts-packaging
       - peer-management-service
+      - node-management
       - proxyd
       - zdd-service
       - snapman
       - op-beat
+      - consensus-awareness
+      - load-balancing
       - monitoring           # General monitoring tools and services
       - analytics           # Analytics platforms and data analysis
       - security-monitoring-response
       - stability-monitoring
       - security
+      - research
+      - beta-features
+      - experimental
+      - feature-testing
+      - decentralization
+      - modularity
+      - system-design
+      - system-configuration
+      - development-networks
+      - network-upgrades
+      - key-management
 
       # Development Languages & SDKs
       - solidity
@@ -187,17 +330,22 @@ metadata_rules:
       - testnet
       - mainnet
 
-      # Superchain Categories
-      - superchain-registry
-      - security-council
-      - blockspace-charters
-
       # Test Networks
       - sepolia          # Ethereum L1 testnet
       - op-sepolia      # OP Stack L2 testnet
       - base-sepolia    # Base testnet
       - zora-sepolia    # Zora testnet
 
+  # IS_IMPORTED_CONTENT
+  is_imported_content:
+    required: true
+    multiple: false
+    validation_rules:
+      - enum:
+          - 'true'
+          - 'false'
+        description: "Must be either 'true' for imported/duplicate pages or 'false' for original pages"
+
   # TIMEFRAME
   timeframe:
     required_for: 

pages/stack/beta-features.mdx

@@ -1,7 +1,19 @@
 ---
 title: Beta Features
-description: Learn how beta features in the OP Stack work, their benefits, and how to provide feedback.
+description: >-
+  Learn how beta features in the OP Stack work, their benefits, and how to
+  provide feedback.
 lang: en-US
+content_type: guide
+topic: beta-features
+personas:
+  - protocol-developer
+  - app-developer
+categories:
+  - protocol
+  - feature-testing
+  - experimental
+is_imported_content: 'false'
 ---
 
 import { Callout } from 'nextra/components'

pages/stack/beta-features/alt-da-mode.mdx

@@ -1,7 +1,21 @@
 ---
-title: Alt-DA Mode explainer
+title: Alt-DA Mode Explainer
+description: >-
+  Learn the basic process, benefits, and considerations for running an Alt-DA
+  mode chain.
 lang: en-US
-description: Learn the basic process, benefits, and considerations for running an Alt-DA mode chain.
+content_type: guide
+topic: alt-da-mode-explainer
+personas:
+  - protocol-developer
+  - chain-operator
+  - app-developer
+categories:
+  - protocol
+  - alt-da
+  - data-availability
+  - sequencer
+is_imported_content: 'false'
 ---
 
 import { Callout } from 'nextra/components' 

pages/stack/components.mdx

@@ -1,7 +1,23 @@
 ---
 title: OP Stack components
+description: >-
+  Learn about OP Stack components including the different layers and modules
+  available for development.
 lang: en-US
-description: Learn about OP Stack components including the different layers and modules available for development.
+content_type: guide
+topic: op-stack-components
+personas:
+  - protocol-developer
+  - chain-operator
+  - app-developer
+categories:
+  - mainnet
+  - protocol
+  - architecture
+  - system-design
+  - modularity
+  - settlement-layer
+is_imported_content: 'false'
 ---
 
 import { Callout } from 'nextra/components'

pages/stack/design-principles.mdx

@@ -1,7 +1,18 @@
 ---
 title: Design philosophy & design principles
+description: >-
+  Learn the design philosophy and design principles for contributing to the OP
+  Stack.
 lang: en-US
-description: Learn the design philosophy and design principles for contributing to the OP Stack.
+content_type: guide
+topic: design-philosophy-design-principles
+personas:
+  - protocol-developer
+  - app-developer
+categories:
+  - protocol
+  - design-philosophy
+is_imported_content: 'false'
 ---
 
 import { Callout } from 'nextra/components'

pages/stack/dev-net.mdx

@@ -1,7 +1,21 @@
 ---
-title: Running a Local Development Environment
-lang: en-US
+title: Running a local development environment
 description: This tutorial walks you through spinning up an OP Stack devnet chain.
+lang: en-US
+content_type: guide
+topic: running-a-local-development-environment
+personas:
+  - protocol-developer
+  - chain-operator
+  - app-developer
+categories:
+  - testnet
+  - protocol
+  - local-development-environment
+  - chain-deployment
+  - kurtosis
+  - docker
+is_imported_content: 'false'
 ---
 
 import {Callout, Steps} from 'nextra/components'