Improve the "Platform documentation" page on how to write docs

[panglesd]

The platform tool guide on how to write documentation is minimal.

I think it would benefit from some examples, explanation on what is a docstring and how it is attached to an item, some explanation of the (basic) syntax, etc. Another content could be "what kind of content to put in docstrings", but this is a bit more personal.

I can give it a shot if there is no volunteer!

[panglesd]

I would also think it would be worth adding a link to it directly from the "Overview" page of "Learning" (maybe only once it is improved), but I don't see which section it could replace...

[cuihtlauac]

I can give it a shot if there is no volunteer!

Please do! Yes, this guide needs to be updated.