nextjs - 💡(How to fix) Fix Docs: Clarify Movement Network Architecture and M1 L1 Migration Details [2 comments, 2 participants]

TL;DR

The Movement Network documentation needs a comprehensive overhaul to clearly explain the M1 Layer 1 architecture and its differences from the previous L2 setup.

Guidance

• Create a dedicated M1 overview section on the documentation page to consolidate information on the new architecture, including validator design, Move VM enhancements, and execution model.
• Review and update existing documentation to reflect the migration from L2 to L1, ensuring that key concepts and changes are clearly explained and easily accessible.
• Consider adding a changelog or migration guide to help developers and contributors understand the implications of the architectural shift.
• Collaborate with ecosystem contributors and developers to ensure the documentation meets their needs and is accurate.

Example

No code snippet is provided as this issue is related to documentation.

Notes

The lack of clear documentation may lead to confusion among developers and contributors, hindering the onboarding process and overall ecosystem growth.

Recommendation

Apply workaround: Create a temporary documentation hub or wiki to centralize information on the M1 Layer 1 architecture until a comprehensive overhaul of the official documentation is completed. This will help reduce confusion and provide a single source of truth for developers and contributors.