search

multiversx / mx-docs

22 stars 142 forks source link

Outdated tutorial #785

Open nounzorus opened 10 months ago

nounzorus commented 10 months ago

Feedback and Suggestions for Development Process Improvements

Hello,

I've been working with your development resources and templates and wanted to share some feedback and suggestions that could enhance the user experience and efficiency.

Issues and Suggestions

  1. Outdated YouTube Videos

    • The YouTube tutorials linked seem outdated, leading to confusion.
    • Suggestion: Update these videos or remove them to avoid misleading information.

  2. Node.js Version Recommendation

    • The default installation on Ubuntu 22 sets Node.js to version 12.
    • Suggestion: Recommend Node.js version 18, or suggest using NVM (Node Version Manager) to allow users to select a compatible Node.js version.

  3. Contract Template Cloning Issue

    • The JSON configuration file in the contract template is no longer valid (Proxy and Chain ID settings are deprecated).
    • Suggestion: Update the template or provide instructions to use a fully parameterized command via the CLI.

  4. DApp Template Configuration

    • After cloning the DApp template, 'src/config.tsx' file is missing.
    • Suggestion: Include steps in documentation to copy 'src/config/config.devnet.ts' to './config.tsx' and modify the import path of 'sharedConfig', or automate this process.

  5. NPM Start Command in DApp Template

    • The command 'npm run start' is invalid; 'npm run start:devnet' is the correct command.
    • Suggestion: Update the documentation to reflect the correct command.

I hope these suggestions help in improving the development experience for this project. Thank you for your hard work and dedication.

Best regards, @noun