fsharp-core-docs icon indicating copy to clipboard operation
fsharp-core-docs copied to clipboard
verified publisher icon fsharp

Missing namespaces?

Open IanWitham opened this issue 9 months ago • 6 comments

FSDocs is finding some namespaces that are not referenced from the hardcoded side navigation:

  • FSharp.Data.UnitSystems.SI.UnitNames
  • FSharp.Data.UnitSystems.SI.UnitSymbols
  • FSharp.Linq.QueryRunExtensions

The documentation pages are generated (e.g. try searching for "Joule" and you'll see it exists), but they aren't discoverable from the existing nav menu.

Is there a reason they have been omitted, or should they be included?

IanWitham avatar Apr 15 '25 23:04 IanWitham

I see there is some previous discussion about this that wasn't resolved #59, #57. Any further thoughts on this?

IanWitham avatar Apr 16 '25 02:04 IanWitham

You could investigate in https://github.com/fsprojects/fsharp.Formatting/ why they are not showing up. This could very well be an actual bug.

nojaf avatar Apr 16 '25 08:04 nojaf

Fsharp.Formatting is indeed processing them, but they have been deliberately omitted from the nav menu (which has been produced manually)

IanWitham avatar Apr 16 '25 08:04 IanWitham

Where are you seeing that?

nojaf avatar Apr 16 '25 08:04 nojaf

Looks like I ran into overflow or spacing problems in the navbar

My CSS foo is not very good

https://github.com/fsharp/fsharp-core-docs/issues/57#issuecomment-669987673

dsyme avatar Apr 16 '25 09:04 dsyme

Putting them in the navbar just made things look very awkward. If they were collapsed by default it would be OK

dsyme avatar Apr 16 '25 09:04 dsyme