api-doc-tools
api-doc-tools copied to clipboard
mono
.NET Reference API Toolchain
From FSharp.Core smoke test:  `OfList` should be `ofList` as per the [existing MSDN entry](https://msdn.microsoft.com/en-us/visualfsharpdocs/conceptual/map.oflist%5b'key,'t%5d-function-%5bfsharp%5d).
From FSharp.Core smoke test:  Each of these are inlined F# functions, but the fact that they're inlined is not relevant to their name.
From FSharp.Core smoke test:  * The `voidptr` type is not recognized, so `nativeptr` is being used in the signature * The `Void*` type is being used in the title...
From FSharp.Core smoke test:  Although this gets the struct constraints correct, critical information about other constraints are missing. See the [MSDN entry on this operator](https://msdn.microsoft.com/en-us/visualfsharpdocs/conceptual/nullableoperators.%5b-sq-%5d%5b%5et1,%5et2,%5et3%5d-function-%5bfsharp%5d):  (Yes, the formatting...
In cases where there are no "empty namespace" types, mdoc still outputs an `ns-.xml` file. This file should only exist if the target libraries have a type in the empty...
We're finding some discrepancies on the DocID format for a couple of APIs. Some examples: **Docs:** M:System.Activities.Presentation.Model.ModelItemDictionary.System#Collections#Generic#ICollection#Add(System.Collections.Generic.KeyValuePair{System.Activities.Presentation.Model.ModelItem,System.Activities.Presentation.Model.ModelItem}) **MSDN:** M:System.Activities.Presentation.Model.ModelItemDictionary.System#Collections#Generic#ICollection{System#Collections#Generic#KeyValuePair{System#Activities#Presentation#Model#ModelItem@System#Activities#Presentation#Model#ModelItem}}#Add(System.Collections.Generic.KeyValuePair{System.Activities.Presentation.Model.ModelItem,System.Activities.Presentation.Model.ModelItem}) **Docs:** M:System.Collections.Concurrent.ConcurrentDictionary\`2.System#Collections#Generic#IDictionary#Add(\`0,\`1) **MSDN:** M:System.Collections.Concurrent.ConcurrentDictionary\`2.System#Collections#Generic#IDictionary{TKey@TValue}#Add(\`0,\`1) **Docs:** M:Microsoft.VisualBasic.Collection.IListAdd(System.Object) **MSDN:** M:Microsoft.VisualBasic.Collection.System#Collections#IList#Add(System.Object)
If you move the xml comment into the `Docs` node, the error goes away.
Each time I run `mdoc update`, I get a new `` element added.
While running mdoc update, I see many errors of the form: “mdoc: Did not find /Type/AssemblyInfo/AssemblyName on /Users/lobrien 1/Downloads/bundle/en/AVFoundation/AVPlayerItemMetadataCollectorPushDelegate_Extensions.xml” And, in fact, that XML file _does not_ contain an `AssemblyName`...
See PR for more context: https://github.com/dotnet/dotnet-api-docs/pull/39 When upgrading .NET Core 2.1 Preview 1 to Preview 2, a couple of signatures have changed. However, mdoc didn't recognize the change and interpreted...