Better Language Documentation as a whole package for newcomers

[jnoortheen]

I am a newbie in F# with strong Python background, trying to do some real-world projects to get a good feel of F#. When I started learning F#, it wasn't a smooth experience. The reason I think are the scattered learning resources and there was no clear path to learn all the basic language constructs.

I have tried some sites suggested in https://fsharp.org/learn.html and they are cluttered and assume that the learner is from C# ecosystem. The books are outdated(using VS and not .NET Core). Other modern languages have great documentation in its main website itself. It gears up the great learning feel. For example

• Rust
• ReasonML
• Nim & even Python

everything in one place up-to-date and serves as a reference whenever needed during the initial phases of learning curve.

Here I really like the docs of ReasonML which clearly have organized all the topics. I think many people have felt the same and off-putting to learn F#. Is it possible to clearup the current documentation of the site? I will be more than happy to work on new pages and would translate from ReasonML for F#. But I am no expert in F# as I mentioned before.

[voronoipotato]

I think the excessive focus on C# comes from the fact that some of us came from the .NET ecosystem and so that was what we knew. However I agree I think it's probably poor pedagogical practice. Even F# for fun and profit slightly falls into this trap in the beginning but if you just skip those parts it it's a good resource.

https://fsharpforfunandprofit.com/posts/key-concepts/

[jnoortheen]

I heard that the F# docs page is getting a revamp. Maybe it is good time to have a central page for the docs in F# site itself.