Skip to content
amuletofyendor edited this page Apr 16, 2025 · 4 revisions

docs.fsharp.org plan-of-attack

Proposal

  • Setup FSDocs Github action, based on fsharp-core-docs Should publish output folder.
  • Include F# Library Reference -- Generated API docs. currently here
  • Include (convert?) Spec non-markdown content -- currently here
  • Include F# Language Spec markdown docs -- currently here
  • Include F# Compiler Docs -- This also generates API docs. currently here
  • Modify old site(s) to 301 redirect page requests to the new docs.fsharp.org
  • Design site navigation to include new content
  • Implement search -- I think FSDocs will only index the generated API docs (i.e. the Library Reference). Another option could be to get an Algoria open source / non-profit license.
  • There are a few links to the current site on learn.microsoft.com. Submit a PR to update these.
  • Improve styling / CSS. Perhaps HTMX boost the site as I did with fsharp.org?
Clone this wiki locally