fsharp / fsharp/fsharp.org

Better Language Documentation as a whole package for newcomers

未关闭
#760 2 条评论 2 个 reaction 已指派 0 人 在 GitHub 查看
主要语言
TeX
星标
311
派生
291
PR 合并指标
30 天内没有已合并 PR

描述

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](https://doc.rust-lang.org/book/)
- [ReasonML](https://reasonml.github.io/docs/en/what-and-why)
- [Nim](https://nim-lang.org/documentation.html)
& even [Python](https://docs.python.org/3/)

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.

贡献指南

这个仓库没有索引到贡献指南

调研方向

首先,审查当前从 fsharp.org/learn.html 链接的资源,并将它们的组织方式、新鲜度和假设与 issue 中引用的示例进行比较。在可以认为工作完成之前,需要将范围缩小为一条已达成共识的学习路径或一组页面。

由索引模型根据 Issue 内容生成。

评估

技术栈
fsharp
领域
documentation
Issue 类型
文档
难度
5/5
预计耗时
一周以上
活跃度
停滞
描述清晰度
需要澄清
新手友好度
25/100

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。