Hi @MikeLemo,
EDITED: For spelling and grammar. Sigh!
Not sure why you would say that, there’s plenty of documentation available, have you looked at Your Gateway to Embedded Software Development Excellence — PlatformIO latest documentation lately? If you want a (large) PDF for offline reading, scroll down the left sidebar until you hit bottom.
Down there you will see “Read the Docs V:Latest”, click “V:Latest”. Under “Downloads”, click on “PDF” to get you to this URL: https://docs.platformio.org/_/downloads/en/latest/pdf/ which will download the latest version of the docs. Currently 2,843 pages. A little light bedtime reading! 
All software has bugs. If you spot one, and want it fixing, tell someone. Have you done so? However, be prepared to be advised that sometimes, a bug in “PlatformIO” is not what it seems. PlatformIO uses Atom/VSCode as an IDE and they have bugs too. Intellisense is a bit of a nightmare in VSCode, for example, but is getting better.
Can you list a few of the “more bugs than software” you refer to and maybe someone will get them sorted to your satisfaction. Thanks.
The Arduino IDE, love it or loathe it, is for beginners really. It’s a great way to get into writing C/C++ code for various microcontrollers using a standard language. Hell, you can even write plain AVR C++ in the IDE if you want. Personally, I found it great for starting off with (back in 2010) but I’ve grown up since then and I now find it a little unwieldy.
I tried to attempt to use Atmel Studio, but that was Windows only and I’m on Linux. Eclipse was too big, too slow and too buggy on my 10 year old (and more) laptop with 2 cores and 8 Gb RAM.
QT Creator and Code:Blocks were tried, PlatformIO can generated project files for these IDEs. QT Creator didn’t like the AVR compiler for some reason and I didn’t pursue it. Code::Blocks was fine, and worked pretty well but C::B isn’t (wasn’t) being supported back then so I moved on.
There wan’t much else at the time, so I ended up on Atom running PlatformIO IDE and have since migrated to VSCode as I really didn’t like Atom. I haven’t looked back. I have been known to use PlatformIO Core in the command line on many an occasion.
It works for me, and I used it to write my first published book, and I’m using it for my next one too. It’s hard enough writing a book for over 2 years, without having to fight with your development tools. I didn’t have to!
I think you are saying that there’s a lot of PlatformIO on YouTube? (English isn’t my first language, I’m a Scotsman!
) To be honest, there’s not much really. A couple of new "getting started " videos from “Dronebot Workshop” and “Gary Explains” but most of the other stuff is years old.
I agree that it’s a good idea to get people into embedded development, and whatever makes it easier is a good thing surely. Unfortunately, you then go on to say:
See above. What bugs are you hitting? Let us know and we can get them fixed.
And, yes, it might be the ever moving target that is VSCode, but if that’s the case, surely piling the blame onto PlatformIO isn’t the way to go? (I’m a database admin and developer by trade, everyone blames the database when things go wrong. It’s never the developer’s code, always the database.
)
Cheers,
Norm.