In above screenshot, for int x, we can see that only the documentation which doesn't have line breaks. The description Some more description..... isn't showed.
This gets more difficult if we are quickly skimming through an API's functions and their usage.

Many of the Flutter Widgets provide an example below them.
It would be excellent to show the full documentation.