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.
This should be ``path()`` to be consistent with ``controller()`` and ``url()``.