Notice (2018-05-24): bugzilla.xamarin.com is now in
Please join us on
Visual Studio Developer Community and in the
Mono organizations on
GitHub to continue tracking issues. Bugzilla will remain
available for reference in read-only mode. We will continue to work
on open Bugzilla bugs, copy them to the new locations
as needed for follow-up, and add the new items under Related
Our sincere thanks to everyone who has contributed on this bug
tracker over the years. Thanks also for your understanding as we
make these adjustments and improvements for the future.
Please create a new report on
Developer Community or GitHub with
your current version information, steps to reproduce, and relevant error
messages or log files if you are hitting an issue that looks similar to
this resolved bug and you do not yet see a matching new report.
Created attachment 23113 [details]
If I Go To Definition of ToolbarItem, I see a collapsed view of the class metadata (see screenshot). I wanted to know what Priority was for, so I expanded its outline group. To my dismay, I saw this:
// Gets or sets the priority of this Xamarin.Forms.ToolbarItem element.
// To be added.
What new information did the comments provide? Absolutely nothing. At the very least, please strip out all meaningless boilerplate comments, so that the outline expansion button won't appear and waste our time. Or preferably, if the meaning isn't obvious from the name (as is the case with Priority), provide real comments that tell us things mean.
We have no plans at this time to remove redundant information from the docs that could be inferred from the name of the method because it was well named in the first place.