Better Language Documentation as a whole package for newcomers
- 主要语言
- 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