dotnet / dotnet-api-docs

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

Reference to nonexistent AssemblyLoadAttribute is confusing #10507

Open jnm2 opened 3 weeks ago

jnm2 commented 3 weeks ago

Type of issue

Missing information

Description

The tables in the Remarks section mention an attribute which is not in the BCL nor recognized by Roslyn, AssemblyLoadAttribute. This is confusing. That row of the the table mentions CorAssemblyFlags which https://learn.microsoft.com/en-us/dotnet/framework/unmanaged-api/metadata/corassemblyflags-enumeration#members mentions is partially covered by a different attribute, https://learn.microsoft.com/en-us/dotnet/api/system.diagnostics.debuggableattribute, which doesn't appear to be a pseudo-attribute (it gets emitted into the custom attributes table). https://learn.microsoft.com/en-us/dotnet/api/system.reflection.assemblyflagsattribute also seems to cover these same debuggable flags as well as more, and this attribute is a pseudo-attribute. Should AssemblyFlagsAttribute or multiple attributes perhaps be linked, rather than stating AssemblyLoadAttribute which does not seem to be a known attribute?

Page URL

https://learn.microsoft.com/en-us/dotnet/api/system.reflection.assembly.getcustomattributes?view=net-8.0

Content source URL

https://github.com/dotnet/dotnet-api-docs/blob/main/xml/System.Reflection/Assembly.xml

Document Version Independent Id

1f2add2c-8aef-80f0-c26f-10754107ea9f

Article author

@dotnet-bot