4 ms·

Complaining about bad docs isn’t really fair IMHO. Compared to Swift F# has excellent documentation. Would be interesting to know what F# is compared with in

Complaining about bad docs isn’t really fair IMHO. Compared to Swift F# has excellent documentation. Would be interesting to know what F# is compared with in this case. Is there a language thats known for excellent docs ? One thing you can’t pass on when talking about fsharp in the community. If you have a question just ask on twitter or slack. You’ll get an answer in minutes.

7331 6y ago
> Is there a language thats known for excellent docs ? They're pretty good for PHP + Rust.
Zababa 6y ago
> Is there a language thats known for excellent docs ? In my experience the Rust docs are great, there's a good mix of types as documentation, high level explanations and examples, with easy access to the source code. Here's an example with the HashMap [1]. There's also the Rust Book [2], which is great because it provides beginners with somewhere to start (F# seems to currently lack this). The situation is pretty much the same with Elixir, great docs [3] and something to get people started [4]. [1]: https://doc.rust-lang.org/std/collections/struct.HashMap.html https://doc.rust-lang.org/std/collections/struct.HashMap.htm... [2]: https://doc.rust-lang.org/book/ https://doc.rust-lang.org/book/ [3]: https://hexdocs.pm/elixir/List.html https://hexdocs.pm/elixir/List.html [4]: https://elixir-lang.org/getting-started/introduction.html https://elixir-lang.org/getting-started/introduction.html
dnautics 6y ago
Is there a language thats known for excellent docs ? Elixir. Main docs: https://hexdocs.pm/elixir/Kernel.html https://hexdocs.pm/elixir/Kernel.html Here's a (3rd party) library's docs. I recommend also checking out "guides" in the upper left corner: https://hexdocs.pm/oban/Oban.html https://hexdocs.pm/oban/Oban.html
Smaug123 6y ago
> Is there a language that's known for excellent docs ? Mathematica's documentation is extremely good (reference.wolfram.com).

7331 6y ago

> Is there a language thats known for excellent docs ? They're pretty good for PHP + Rust.

Zababa 6y ago

> Is there a language thats known for excellent docs ? In my experience the Rust docs are great, there's a good mix of types as documentation, high level explanations and examples, with easy access to the source code. Here's an example with the HashMap [1]. There's also the Rust Book [2], which is great because it provides beginners with somewhere to start (F# seems to currently lack this). The situation is pretty much the same with Elixir, great docs [3] and something to get people started [4]. [1]: https://doc.rust-lang.org/std/collections/struct.HashMap.html https://doc.rust-lang.org/std/collections/struct.HashMap.htm... [2]: https://doc.rust-lang.org/book/ https://doc.rust-lang.org/book/ [3]: https://hexdocs.pm/elixir/List.html https://hexdocs.pm/elixir/List.html [4]: https://elixir-lang.org/getting-started/introduction.html https://elixir-lang.org/getting-started/introduction.html

dnautics 6y ago

Is there a language thats known for excellent docs ? Elixir. Main docs: https://hexdocs.pm/elixir/Kernel.html https://hexdocs.pm/elixir/Kernel.html Here's a (3rd party) library's docs. I recommend also checking out "guides" in the upper left corner: https://hexdocs.pm/oban/Oban.html https://hexdocs.pm/oban/Oban.html

Smaug123 6y ago

> Is there a language that's known for excellent docs ? Mathematica's documentation is extremely good (reference.wolfram.com).