Constructor property setters should include documentation for those properties

[tvolkert]

Consider the following constructor:

https://api.flutter.dev/flutter/material/MaterialApp/MaterialApp.html

It looks like this in the API docs:

None of the parameters to the constructor are documented... despite every single one of the corresponding member variables being documented (e.g. https://api.flutter.dev/flutter/material/MaterialApp/localizationsDelegates.html).

Our dartdocs should make it clear that these constructor parameters are setting the corresponding member variables and either (a) provide a hyperlink to the documentation for the corresponding member variables, or (b) inline those docs in a way that would be easy for a human to parse.

Note that this is particularly bad for new developers, because they don't necessarily know that these constructor parameters even map to member variables that [might] have their own docs.

[tvolkert]

Cross-filing from flutter/flutter#80292

[jcollins-g]

Adding designer label as all the data is available in the templates, someone will just need to come up with something that looks reasonable here.

[tvolkert]

@jcollins-g do you know who usually does the designs?

[guidezpl]

Would love to see this, plus support for this and super. The constructor pages are currently super helpful.

Related: #1451 and #1229

[InMatrix]

Would it be sufficient to turn the parameters of the constructor into links to corresponding properties' docs?

[a-siva]

//cc @srawlins do you know who in the dartdoc team should be looking into this?