api-doc-tools
api-doc-tools copied to clipboard
.NET Reference API Toolchain
We have such source code as https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/confidentialledger/Azure.Security.ConfidentialLedger/src/Generated/ConfidentialLedgerClient.cs#L873-L896 with `` tag inside ``. But in https://azuresdkdocs.blob.core.windows.net/$web/dotnet/Azure.Security.ConfidentialLedger/1.0.0-beta.2/api/Azure.Security.ConfidentialLedger/Azure.Security.ConfidentialLedger.ConfidentialLedgerClient.html#Azure_Security_ConfidentialLedger_ConfidentialLedgerClient_CreateOrUpdateUser_System_String_Azure_Core_RequestContent_Azure_RequestOptions_, it is rendered in an unreadable format. 
https://github.com/mono/api-doc-tools/blob/c503071997d1cfcdb5a039a8a36e530412cb0acb/monodoc/monodoc.dll.config#L3 This is not substituted in the shipped nuget package
Getting the following error: ``` Run D:\a\decksurf-sdk\decksurf-sdk\_mdoc\mdoc.exe update --debug --out _xml -fx frameworks.xml --use-docid D:\a\decksurf-sdk\decksurf-sdk\_mdoc\mdoc.exe update --debug --out _xml -fx frameworks.xml --use-docid shell: C:\Program Files\PowerShell\7\pwsh.EXE -command ". '{0}'" mdoc 5.8.3...
This was to be fixed in a PR but we realized that you can't just edit the file because the structure/signatures are auto generated from the code. I'm unsure why...
The nullable feature supports the constructor, field, property, method, event, and operator overriding for ECMA2YAML to consume.
I noticed that the FrameworkAlternate attribute is now missing from the assembly attributes in the index.xml file. /Overview/Assemblies/Assembly/Attributes/Attribute Not sure when it stopped appearing.
We still have some missing attached properties - System.Windows.Controls.Validation.HasError https://msdn.microsoft.com/library/system.windows.controls.validation.haserror?toc=xxx - System.Windows.Controls.Validation.Errors https://msdn.microsoft.com/library/system.windows.controls.validation.errors.aspx?toc=xxx - System.Windows.Shell.WindowChrome.ResizeGripDirection https://msdn.microsoft.com/library/system.windows.shell.windowchrome.resizegripdirection.aspx?toc=xxx - System.Windows.VisualStateManager.VisualStateGroups https://msdn.microsoft.com/library/system.windows.visualstatemanager.visualstategroups.aspx?toc=xxx - System.Windows.Localization.Attributes https://msdn.microsoft.com/library/system.windows.localization.attributes.aspx?toc=xxx - System.Diagnostics.PresentationTraceSources.TraceLevel https://msdn.microsoft.com/library/system.diagnostics.presentationtracesources.tracelevel.aspx?toc=xxx
This is an issue brought up by @riverar on https://github.com/MicrosoftDocs/feedback/issues/298#issuecomment-444980502 Type: https://docs.microsoft.com/en-us/dotnet/api/accessibility.caccpropservicesclass According to the docs, there is no parameter-less constructor for ClassInterfaceAttribute. mdoc is generating this: ```xml System.Runtime.InteropServices.ClassInterface ```...