search

MicrosoftDocs / winrt-api

WinRT reference content for developing Microsoft Universal Windows Platform (UWP) apps
Creative Commons Attribution 4.0 International
229 stars 494 forks source link

GridLength documentation doesn't make it clear what the default values are. #312

Open michael-hawker opened 6 years ago

michael-hawker commented 6 years ago

https://docs.microsoft.com/en-us/uwp/api/Windows.UI.Xaml.GridLength

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

jwmsft commented 5 years ago

It's standard in the API documentation to list a default value on the property where it's set, not with the value type. For example, ColumnDefinition.Width shows the default GridLength value for that property.

michael-hawker commented 5 years ago

Thanks @jwmsft, I think the main issue I always face is this need to drill-in to the right spot from somewhere else. If I'm looking for this type of info, I'm going to look at the ColumnDefinition docs first and look at the properties list:

image

That doesn't provide me any info about the default value. ☹

Therefore, since I'm already reading the description and it tells me it's a GridLength type, I end up there. But now, I'm not going to think there's another page for ColumnDefinition.Width that will tell me what the default value is...

It'd be great if we could better consolidate some of the control documentation to make it easier to get the information developers need vs. having to train them to hunt for it in certain docs. Looking up enum values from a property leads to a hunt like this sometimes too (especially if you need the numerical value for it, if it's even in the docs).