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 isn't rendered properly. It will finally display like this:

```
**type**: string``|``ControllerReference
```