Hi Pedro,
Thank you so much for your idea. I am marking this as "on our radar" since we have plans to improve this area of documentation (still no date for a delivery, though). While this topic isn't improved, I hope you find Paulo's reply useful already.
We also have a submit feedback option at the bottom of our documentation pages. We often give an eye on it there too, so keep the feedback coming :)
Thanks again!