api-doc-tools
api-doc-tools copied to clipboard
mono
.NET Reference API Toolchain
We'll need a way to show units of measure with mdoc so that we can migrate the FSharp.Core API reference over.
We'll need a way to show `inline` for F# type signatures when migrating the FSharp.Core API reference.
We'll need a way to show SRTP in type signatures to migrate the FSharp.Core API reference over.
From F# smoke test:  The tool currently reads in the F# list type and its DU tags as separate types. They should be considered the same type so that...
F#om F# smoke test:  The module is correctly picked up, but it is treated as a static class with static methods. While technically true from an IL level, this...
From F# smoke test:  Although these compile down with the FSharp prefix, this should be chopped off. Exceptions include: * FSharpFunc
From F# smoke test:  The `unit` type in F# implements these, but this is a given in F# and isn't something you call in F# code.
 F# lists are default equatable, which is a property of F# (despite being implemented like this under the covers). We shouldn't show these in the API reference.
 GetSlice is an implementation detail for slicing in F#; e.g., `lst.[5..]`.
Type abbreviations are currently missing from the tool. For example, here is `byte` listed in the [F# MSDN reference](https://msdn.microsoft.com/en-us/visualfsharpdocs/conceptual/core.byte-type-abbreviation-%5bfsharp%5d).  These abbreviations represent the most core types people use in...