I always found the user notes in PHP docs super helpful.
just picking one random page to show it in action: https://www.php.net/manual/en/reserved.variables.request.php
Often the rails docs are pretty thin. User notes can contribute the helpful ‘here is an example/insight’
The clear demarcation between docs and user notes tacitly acknowledges that the user comments may need to be taken with a pinch of salt!