update template

Author: todortodorovic

.CONTRIBUTING/tutorials/templates/governance-template.md

@@ -24,7 +24,7 @@ Before starting, ensure you have:
 - Access to Polkadot.js Apps or governance interface
 - [Specific requirements based on tutorial type]
 
-## Step 1: Understanding the Governance System
+## Understanding the Governance System
 
 [Explain the specific governance mechanism being used]
 
@@ -40,7 +40,7 @@ For this tutorial, we'll focus on:
 - **Decision Period**: [Timeline information]
 - **Required Approval**: [Approval/support thresholds]
 
-## Step 2: [Specific Governance Action Setup]
+## [Specific Governance Action Setup]
 
 ### For Creating Proposals:
 [Steps to create and submit a proposal]
@@ -111,7 +111,7 @@ const delegate = api.tx.convictionVoting.delegate(
 !!!tip "Screenshot Guidelines"
     Use 1512px width for desktop screenshots. Crop to show only relevant interface elements.
 
-## Step 4: Monitoring and Participation
+## Monitoring and Participation
 
 Track the progress of governance actions:
 
@@ -128,7 +128,7 @@ Track the progress of governance actions:
 - **Turnout**: Total voting power participating
 - **Time Remaining**: Decision period countdown
 
-## Step 5: Understanding Results and Next Steps
+## Understanding Results and Next Steps
 
 Analyze the outcome of your governance participation:
 

.CONTRIBUTING/tutorials/templates/polkadot-sdk-template.md

@@ -24,7 +24,7 @@ Before starting, ensure you have:
 - Basic understanding of [required concepts]
 - [Tokens/accounts if needed]
 
-## Step 1: Project Setup
+## Project Setup
 
 [Set up the development environment and project structure]
 
@@ -41,7 +41,7 @@ Expected output:
 [Show expected terminal output]
 ```
 
-## Step 2: [Main Development Phase]
+## [Main Development Phase]
 
 [Core implementation steps - adjust based on tutorial type:]
 
@@ -55,7 +55,7 @@ Expected output:
 - Implement extrinsics
 - Add tests
 
-```rust
+```rust title="lib.rs"
 // Example code with clear comments
 #[pallet::storage]
 pub type SomeValue<T> = StorageValue<_, u32>;
@@ -64,7 +64,7 @@ pub type SomeValue<T> = StorageValue<_, u32>;
 !!!tip
     Explain key concepts or provide helpful context here.
 
-## Step 3: Testing and Verification
+## Testing and Verification
 
 Test your implementation:
 
@@ -81,11 +81,6 @@ Verify everything works by:
 2. [Specific verification step 2]
 3. [Expected behavior/output]
 
-## Step 4: [Advanced Configuration - if applicable]
-
-[Optional advanced steps for intermediate/advanced tutorials]
-
-
 ## Where to Go Next
 
 Continue your Polkadot SDK journey with:

.CONTRIBUTING/tutorials/templates/smart-contracts-template.md

@@ -19,26 +19,27 @@ categories: Smart Contracts, EVM, PVM, DeFi
 Before starting, ensure you have:
 
 - **For EVM/PVM contracts**: Remix IDE or local development setup
-- MetaMask wallet configured for [specific network]
+- Ethereum-compatible wallet set up for [specific network]
 - Test tokens for deployment and testing
 - Basic understanding of [Solidity/Rust/relevant language]
 
-## Step 1: Development Environment Setup
+## Development Environment Setup
 
 [Set up the appropriate development environment]
 
 ### For EVM Contracts:
+
 ```bash
 # Install required tools
 npm install -g @openzeppelin/cli@VERSION
 npm install hardhat
 ```
 
-## Step 2: Contract Design and Structure
+## Contract Design and Structure
 
 [Explain the contract architecture and key components]
 
-```solidity
+```solidity  title="Contract.sol"
 // For EVM contracts - example structure
 pragma solidity ^0.8.19;
 
@@ -55,7 +56,7 @@ contract YourContract {
     }
 }
 
-## Step 3: Contract Implementation
+## Contract Implementation
 
 [Step-by-step implementation of core functionality]
 
@@ -69,7 +70,7 @@ contract YourContract {
 !!!warning
     Important security considerations specific to this contract type.
 
-## Step 4: Testing
+## Testing
 
 Write comprehensive tests:
 
@@ -90,7 +91,7 @@ Run tests:
 npx hardhat test
 
 
-## Step 5: Deployment
+## Deployment
 
 Deploy your contract:
 
@@ -101,7 +102,7 @@ npx hardhat run scripts/deploy.js --network [testnet-name]
 ```
 
 
-## Step 6: Interaction and Verification
+## Interaction and Verification
 
 Test contract functionality:
 
@@ -114,16 +115,6 @@ Test contract functionality:
 
 ![Contract interaction screenshot](/images/tutorials/smart-contracts/[category]/[tutorial-name]/contract-interaction.webp)
 
-## Advanced Features [Optional]
-
-[For intermediate/advanced tutorials - additional features like:]
-- Integration with oracles
-- Advanced token mechanics
-- Cross-contract calls
-- Upgradeable patterns
-
-
-
 ## Where to Go Next
 
 Extend your smart contract skills:

.CONTRIBUTING/tutorials/templates/xcm-interoperability-template.md

@@ -25,7 +25,7 @@ Before starting, ensure you have:
 - Basic understanding of XCM concepts
 - Access to testnet networks (if applicable)
 
-## Step 1: Chopsticks Environment Setup
+## Chopsticks Environment Setup
 
 First, we'll set up Chopsticks to simulate the network environment for XCM testing.
 
@@ -53,7 +53,7 @@ const networks = {
 2. Fund accounts with necessary tokens
 3. Verify account balances
 
-## Step 2: Understanding the Cross-Chain Flow
+## Understanding the Cross-Chain Flow
 
 [Explain the specific XCM operation being performed]
 
@@ -76,7 +76,7 @@ let xcm = Xcm(vec![
 2. **Relay Chain**: [How the relay chain processes the message]
 3. **Destination Chain**: [What happens on the destination chain]
 
-## Step 3: [Specific XCM Operation - e.g., Asset Transfer]
+## [Specific XCM Operation - e.g., Asset Transfer]
 
 [Detailed steps for the specific cross-chain operation]
 
@@ -99,12 +99,7 @@ const transfer = api.tx.xcmPallet.limitedReserveTransferAssets(
 );
 ```
 
-![XCM transaction setup](/images/tutorials/interoperability/[category]/[tutorial-name]/xcm-setup.webp)
-
-!!!tip "Screenshot Dimensions"
-    Desktop screenshots: 1512px width, variable height. Browser extensions: 400x600px.
-
-## Step 4: Execution and Monitoring
+## Execution and Monitoring
 
 Execute the cross-chain operation:
 
@@ -120,7 +115,7 @@ Execute the cross-chain operation:
 cargo run -- monitor-xcm --transaction-hash [hash]
 ```
 
-## Step 5: Verification
+## Verification
 
 Verify the successful cross-chain operation:
 
@@ -134,24 +129,6 @@ Expected results:
 - Destination chain balance: [Expected change]
 - XCM execution status: Success
 
-## Testing with XCM Simulator [Optional]
-
-For development and testing:
-
-```rust
-// XCM Simulator test setup
-use xcm_simulator::*;
-
-#[test]
-fn test_cross_chain_transfer() {
-    // Test implementation
-}
-```
-
-## Advanced XCM Patterns [For Advanced Tutorials]
-
-[Include for intermediate/advanced tutorials:]
-
 ### Multi-hop XCM
 - Routing through multiple chains
 - Complex asset transformations

tutorials/README.md

@@ -21,4 +21,4 @@ Ready to contribute a tutorial? Get started here:
 - **dapps/** - Frontend integration, API usage
 - **onchain-governance/** - Proposals, OpenGov operations
 
-Start with working code, clear steps, and we'll help you polish the rest! 
+Start with working code, clear steps, and the team will help you polish the rest!