On 12/14/20 5:24 PM, Aureliano Guedes wrote:
That's why, as a community-developed language (including docs) I'd like to suggest to you help to improve the docs. This way, when I have - with some lucky - free time, I may learn with you and all others that wrote these docs.
Hi Aureliano, I absolutely adore Raku. But the docs are truly awful. They do not start out simple and build to the complex. They throw terms out without defining them. They use things in examples that are require advanced level of knowledge to understand, and so on and so forth. They have broken virtually rule of technical writing. The docs are simply refreshers for those that already know what they are doing and do not need them. I have tried several times to contribute to and get the docs improved. I have been told I am providing too much detail or just get ignored. So I have stopped. The culture of the "docs" is not something I can change. I would absolute love to see some kind of contributed docs portal that any user could pick out a subject and write on it with the ability for others to correct mistakes or add content. Once I get Classes and Object figured out, I will write my own documentation of the subject. If I think it is good enough to share (some of my technical writing stinks too), I will post it back here. For starters, I need to have the definition of "class" and "object". Then I need their rules. -T
