Thread by @dsymetweets

Today we rolled out numerous improvements to the F# docs at docs.microsoft.com/dotnet

1. The F# Language Guide is now properly organized, from see docs.microsoft.com/en-us/dotnet/f…

2. The front page now features "F# in practice" including a new page on "F# for web development"

docs.microsoft.com/dotnet/fsharp/…

This includes links to some key frameworks plus a link to the F# Software Foundation guide to F# web development for more comprehensive community listings

This is also linked on the very front page of the .NET docs docs.microsoft.com/en-us/dotnet/#…

3. The front page also features "F# for machine learning". This page features a few resources (please add more!) and again links to the @fsharporg pages for comprehensive community listings (you can add more material there too).
docs.microsoft.com/dotnet/fsharp/…

4. The front page also features "Deploying and Managing Azure Resources" and links to Farmer, the community-developed tool for using F# for this docs.microsoft.com/dotnet/fsharp/…

5. We now have a dedicated page for using Apache Spark with F# on Azure

docs.microsoft.com/dotnet/fsharp/…

6. We now have thin link-based pages under "F# tooling" (previously only had one entry, despite so many tools being available for F#!). This includes a page on .NET Interactive notebooks docs.microsoft.com/dotnet/fsharp/… and F# dev tools docs.microsoft.com/dotnet/fsharp/…. Please add more

7. F# is also a JavaScript language and the docs now reflect that, with a page linking to the two excellent F# to JS toolchains @FableCompiler and @WebSharper docs.microsoft.com/dotnet/fsharp/…

8. For people wanting an overview of the F# language, this is the landing page for the F# language guide, it's now well organized. You can glance through it quickly to confirm that you know the principle areas of the language and find what you need

docs.microsoft.com/dotnet/fsharp/…

9. The F# docs have been updated for F# 6, for example tasks docs.microsoft.com/dotnet/fsharp/…

10. Functional programming has been de-emphasized in the learning sequence - the "succinct, robust and performant" properties of F# are emphasized that align and FP emerges as a practical technique, rather than being something you need to learn before you start to code

That's all for now. Please help us improve the docs - they are open source and ready for your loving and thoughtful contributions: github.com/dotnet/docs/tr…. A planning issue where @KathleenDollard and I are recording future work is here: github.com/dotnet/docs/is…