Improved and fixed twig reference

| Q   | A
| --- | ---
| Doc fix? | yes
| New docs? | yes
| Applies to | 2.3+
| Ficket tickets | #4301 

Removed the ugly looking tables and added some more details.
To be more precise: Sphinx assumes that there is a ``controller.rst`` document in the same directory as the current document.