Your contribution is very much welcome. The clearer the documentation. The easier Drupal will be to work with.
Please add your suggestion below in the comments if you feel this section as a whole could be improved.
This is not a place for support requests or comments on examples on individual pages in this section.