[BUG] Readme needs to be refactored

[atsju]

As a first time user i see things with a different eye than experiences users.
IMO the readme is unclear. For installation it should rely completely on wiki (today there is information in both).
I can't refactor it myself without discussing with some user that knows everything.

[github-actions]

Thank your for submiting, please be sure you followed template or your issue may be dismissed. if you deleted the template it is here

[luc-github]

I fully agree - but most of people do not read the wiki and even not check the readme - they prefer to watch youtube video which is almost all the time outdated, when people say they cannot do even reading the readme/wiki and I ask what did they did not understood - so I can improve it - they usually never answer ...

spend time on a full documentation that people do not take time to read vs spend time on code and fix bug => I did my choice

This also why I tried to move to platformio - it simplify a lot the installation / compilation steps - all is ready, just update the configuration.h, which I try to fill with lot of comments, and choose the target board ....this is the purpose of #478

Using arduino is more tricky for the installation. but arduino is also more up to date for board / chip support

That said every contribution for documentation is welcome, and I would be more than happy to get nice documentation - but it won't come from me until my todo list is done ( in some years I guess 😸 ), it is definitly not my priority

[atsju]

I understand the fact of moving to platformIO. Marlin users already are on platformIO so I think it's good to have same tools.

If I was to rewrite the documentation, is the platformIO version ready and recommended with 2.1.1 or shall 2.1.1 always build with Arduino ?

[luc-github]

yes it is : https://github.com/luc-github/ESP3D/blob/2.1.x/platformio.ini

but some people are scared of platformIO - I already see people trying to compile Marlin with arduino because - platformIO is confusing for them