update tutorial contributing

Author: todortodorovic

.CONTRIBUTING/.CONTRIBUTING.md

@@ -238,27 +238,15 @@ In general, titles should be between 50 and 60 characters and descriptions shoul
 
 ## Contributing Tutorials
 
-For step-by-step tutorials, we have a specialized workflow and dedicated guides. Start with the [**tutorials overview**](tutorials/README.md) to see all available options, or jump directly to:
-
-### Quick Tutorial Contributing
-- **[Quick Guide](tutorials/QUICK_GUIDE.md)** - Essential requirements for experienced contributors
-- Focus on working code and clear instructions
-- Everything else is optional and can be refined during review
-
-### Detailed Tutorial Guidelines
-- **[Style Guide](tutorials/STYLE_GUIDE.md)** - Comprehensive guide with detailed formatting rules
-- **[Templates](tutorials/templates/)** - Ready-to-use templates for different tutorial categories:
-  - Polkadot SDK tutorials
-  - Smart contracts tutorials
-  - XCM/Interoperability tutorials
-  - dApps tutorials
-  - Governance tutorials
-
-### Tutorial Categories
-- **polkadot-sdk/**: Parachains, pallets, runtime development
-- **smart-contracts/**: EVM contracts, ink! contracts, demo applications
-- **interoperability/**: XCM operations, cross-chain workflows
-- **dapps/**: Frontend development, API integrations
-- **onchain-governance/**: Proposals, voting, delegation
+For step-by-step tutorials, we have a specialized workflow and dedicated guides:
+
+ **[Tutorial Contributing Guide](tutorials/.CONTRIBUTING.md)**
+
+This includes:
+
+- **Requirements** - Essential metadata and file structure
+- **Categories** - SDK, smart contracts, XCM, dApps, governance
+- **Templates** - Ready-to-use templates for different tutorial types
+- **Guidelines** - Code standards, testing, and submission process
 
 Tutorials follow a different structure than general documentation and have specific requirements for metadata, file organization, and navigation updates.

.CONTRIBUTING/tutorials/QUICK_GUIDE.md .CONTRIBUTING/tutorials/.CONTRIBUTING.md.CONTRIBUTING/tutorials/QUICK_GUIDE.md renamed to .CONTRIBUTING/tutorials/.CONTRIBUTING.md

@@ -1,6 +1,33 @@
-# Contributing Tutorials - Quick Guide
+# Contributing Tutorials
 
-Fast-track guide for experienced contributors. For detailed explanations, see [STYLE_GUIDE.md](STYLE_GUIDE.md).
+## Choose Your Contributing Path
+
+### Team-Assisted Path (Recommended)
+**Allow the team to handle formatting and style**
+
+ **Benefits:**
+- Faster review process
+- Fewer style-related review comments
+- Team handles technical formatting requirements
+
+ **Your responsibility:**
+- Working code and clear instructions
+- Following essential requirements below
+
+ **Important:** Enable "Allow edits by maintainers" on your PR
+
+**Recommendation:** Even with team assistance, reviewing the [STYLE_GUIDE.md](STYLE_GUIDE.md) helps you create better tutorials from the start.
+
+### Self-Managed Path
+**Handle all formatting and style requirements yourself**
+
+ **Full control** over your tutorial format and style
+ **More review rounds** - you must fix all style issues
+ **Required reading:** [STYLE_GUIDE.md](STYLE_GUIDE.md)
+
+---
+
+# Team-Assisted Path: Essential Requirements
 
 ## Essential Requirements
 
@@ -82,12 +109,28 @@ images/tutorials/[category]/[subcategory]/[tutorial-name]/
 - [ ] Files follow naming conventions
 - [ ] Verification steps included
 
-## Quick Links
+---
 
-- **Templates**: [templates/](templates/) folder
-- **Style Guide**: [STYLE_GUIDE.md](STYLE_GUIDE.md)  
-- **Examples**: Browse existing tutorials for reference
+# Self-Managed Path: Complete Requirements
+
+If you choose the self-managed path, you must follow **all** requirements in [STYLE_GUIDE.md](STYLE_GUIDE.md), including:
+
+- Complete metadata specifications
+- Image optimization and formatting
+- Navigation file updates (.nav.yml)
+- Advanced style and formatting rules
+- SEO optimization requirements
+
+**Note:** All style-related review comments must be addressed by you.
 
 ---
 
-Need help? Check the [detailed style guide](STYLE_GUIDE.md) or existing tutorials for examples.
+## Resources
+
+- **Templates**: [templates/](templates/) folder - Ready-to-use templates for different tutorial categories
+- **Style Guide**: [STYLE_GUIDE.md](STYLE_GUIDE.md) - Complete formatting requirements (recommended for all, required for self-managed)
+- **Examples**: Browse existing tutorials for reference
+
+**Questions?** The team is here to help regardless of which path you choose!
+
+---

.CONTRIBUTING/tutorials/STYLE_GUIDE.md

@@ -1,6 +1,12 @@
 # Tutorial Style Guide - Detailed Reference
 
-Comprehensive guide for tutorial writing standards, formatting, and best practices. For quick reference, see [QUICK_GUIDE.md](QUICK_GUIDE.md).
+Comprehensive guide for tutorial writing standards, formatting, and best practices. 
+
+**For contributors using the Self-Managed Path:** This guide contains all requirements you must follow.
+
+**For contributors using the Team-Assisted Path:** This guide is recommended reading to create better tutorials from the start, but the team will handle most formatting requirements for you.
+
+Quick reference available at: [TUTORIALS_CONTRIBUTING.md](.CONTRIBUTING.md)
 
 This guide covers tutorial-specific requirements and formatting. For general writing guidelines that apply to all documentation, refer to the [PaperMoon Documentation Style Guide](https://github.com/papermoonio/documentation-style-guide).
 
@@ -385,6 +391,6 @@ Before submission:
 
 For additional help:
 1. Check existing tutorials for examples
-2. Review the [quick contributing guide](QUICK_GUIDE.md)
+2. Review the [main contributing guide](.CONTRIBUTING.md)
 3. Open an issue for clarification
 4. Join the Polkadot developer community discussions

tutorials/README.md

@@ -0,0 +1,24 @@
+# Contributing Tutorials
+
+## Quick Start
+
+Ready to contribute a tutorial? Get started here:
+
+👉 **[Tutorial Contributing Guide](../.CONTRIBUTING/tutorials/.CONTRIBUTING.md)**
+
+## What You'll Find
+
+- **Requirements** - Essential metadata and file structure
+- **Categories** - Where your tutorial belongs (SDK, smart contracts, XCM, etc.)
+- **Templates** - Ready-to-use templates for different tutorial types
+- **Guidelines** - Code standards, testing, and submission process
+
+## Tutorial Categories
+
+- **polkadot-sdk/** - Parachains, pallets, runtime development
+- **smart-contracts/** - EVM, ink!, demo applications  
+- **interoperability/** - XCM operations, cross-chain workflows
+- **dapps/** - Frontend integration, API usage
+- **onchain-governance/** - Proposals, OpenGov operations
+
+Start with working code, clear steps, and we'll help you polish the rest!