The problem might not be the documentation. For example, assigning an id field to an automation is described in the example in the YAML section for automations. Changing an entity’s options is described in the link posted above.
The documentation is created by the community. If you believe it should be improved, feel free to volunteer your time to do it. At the bottom of each page there’s a link to edit the page. Full instructions for modifying documentation can be found here: