search

dotnet / dotnet-api-docs

.NET API reference documentation (.NET 5+, .NET Core, .NET Framework)
https://docs.microsoft.com/dotnet/api/
Other
702 stars 1.55k forks source link

Documentation of dependency properties is not consistent and confusing. #10351

Open OwenFromAI opened 1 week ago

OwenFromAI commented 1 week ago

Type of issue

Missing information

Description

[Enter feedback here] Many dependency properties include "This is a dependency property" in their description. However, not all dependency properties include it. This can be confusing, as you might think you can't use a property like Foreground as the target of a binding. But it IS a dependency property. It just isn't documented as consistently as the others. This feels like something you could make a generator do for you.

Page URL

https://learn.microsoft.com/en-us/dotnet/api/system.windows.controls.textblock?view=windowsdesktop-8.0

Content source URL

https://github.com/dotnet/dotnet-api-docs/blob/main/xml/System.Windows.Controls/TextBlock.xml

Document Version Independent Id

519366a4-ef79-f1e2-e75c-87595f416fef

Article author

@dotnet-bot

dotnet-policy-service[bot] commented 1 week ago

Tagging subscribers to this area: @dotnet/wpf-developers

krwq commented 1 week ago

@OwenFromAI are you interested in making a PR?