vector0:
...
arduino is for beginners and for open-source
The fact that it is open source is not a guarantee it is a perfect product.
In fact I think it is impossible to include all documentation, it is far more than one can imagine and most is available on the internet just 2 or 3 googles away. (but most people do not know how to use the extended features of google).
E.g. Arduino uses C/C++ with dedicated libraries but it does not provide a C/C++ course. But there are plenty good books and websites to do that.
it should have the documents to everything sold with the name "arduino"
I disagree because the complete document set would be extremely large. The Arduino.cc site is not the best website definitely not, but it provides a lot of information and links. And the amount is growing by the day.
it should give programming interfaces and macro for asm on proc of all arduino boards too
No as the core processors differ that would mean different documentation. The core of the Arduino philosophy is that you have one C/C++ language together with Arduino libraries that will run on many different boards. The sketches are quite portable (to certain extend)
Assembler code is definitely not.
i wrote that it should give links to the documents as they exist somewhere
someone wanting to do asm can manage using tools anyway
I agree there is a lot to be improved wrt documentation, including assembly.
You (we) can create a page on the playground with links to assembler and assembler related issues.
Note that the moderators of the forum have no moderation rights on the website