api-doc-tools

api-doc-tools copied to clipboard

We'll need a way to show units of measure with mdoc so that we can migrate the FSharp.Core API reference over.

@cartermp yeah, this came up when we were first developing the F# signatures ... am I incorrect in thinking that the units of measure is entirely a compile-time signifier? If that's the case, then that means the information is not included in the final assemblies from which we generate the documentation updates, right?

Yes, they are erased. Example.

Honestly, the only way forward here (from a technical standpoint) seems like it would be to have the tool understand every part of FSharp.Core that defines a unit of measure and then emit the correct signature for each one of those cases.