Hello Stack Exchange Ethereum list members: Can someone recommend a better resource for Solidity programming documentation other than solidity.readthedocs.io?
To the Ethereum Documentation Team: The documentation located here >>> http://solidity.readthedocs.io is riddled with grammar issues, misspellings and spacing problems. It does not to give great detailed guidance and clear clean step by step or progressively complex code examples. There are extremely important keywords, reserved words and other important Solidity specific functions explanations that you use EVERYWHERE in your code examples that have been hidden under a "Miscellaneous" section heading for some strange reason. Once they are finally found, that leads to more disappointment because they have little or no definitions and examples to complement them. The grammar.txt file on your Github site seems like an extreme example of this problem. This file is an afterthought at best.
Other issues include examples like the following; a topic starts on a subject like "Mapping" with links to wiki pages that go way too much into depth on hash functions instead of just telling me how Solidity uses mapping in its code. There are way too many outside links to other websites that simply are off the mark with too detailed explanations about every conceivable configuration option, historical fact and theoretical reason why one word or subject was developed. This instead of just telling me how Solidity uses it and how I should use it to code contracts. It is not those external websites' responsibility to relate their subject matter to what I need to learn for using Solidity. It is the Solidity document's responsibility.
Next example, a topic on "Modifiers" gives maybe a few sentences on why and how to use it. Then the explanation immediately jumps into a complicated and almost non-related example. That example moves to advanced topics like Inheritance without clear, simple and detailed guidance on how and why Solidity uses modifiers. As a matter of fact, the entire documentation set for Solidity seems like a last minute thought where someone quickly grabbed some old code and just added comments to it. No, that's exactly what was done when I look at sections like "Solidity by Example". That section is almost useless as it almost solely relies on the comments in the program before even the first introduction into the specifics of Solidity coding principles and concepts.
Lastly, the main headings are not organized or labeled well and have unrelated subjects in them. As an example, why in the world is the subject if Libraries hidden underneath the Main "Contracts" header instead of under its own header? Why in the world would the subject of Functions not have its own header given the extreme importance of it in Solidity programming?
Judging by the over 14 thousand issues here alone, there is indeed a documentation problem. There are some great heroes on YouTube and other places who are giving MUCH MUCH better guidance than the supposed central location for documentation. Please, please, reach out to them and pay them some Ether to help you develop better docs OR; just post their videos on your doc site.