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.
But using

```rst
**type**: ``string|ControllerReference``
```

would work.