search

mono / api-doc-tools

.NET Reference API Toolchain
MIT License
68 stars 48 forks source link

F#: units of measure #276

Open cartermp opened 6 years ago

cartermp commented 6 years ago

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

joelmartinez commented 6 years ago

@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?

cartermp commented 6 years ago

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.