Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

The 'Why' of 'What & Why' is vague and lacks evidence #729

Closed
Jazzyboy1 opened this issue May 23, 2021 · 1 comment · Fixed by #765
Closed

The 'Why' of 'What & Why' is vague and lacks evidence #729

Jazzyboy1 opened this issue May 23, 2021 · 1 comment · Fixed by #765

Comments

@Jazzyboy1
Copy link

Context: https://reasonml.github.io/docs/en/what-and-why#why-use-reason

Reading that section as an already persuaded novice disciple of functional programming, I learn nothing new, and it seems to be a very general statement that applies equally to alternative functional-first languages. What does Reason bring to the table that alternatives don't or which is better than alternatives' offerings?

Also; if I wasn't already persuaded of the merits of functional programming and strong typesystems, then I can't imagine the current brief paragraph being enough to persuade me. It's vague and doesn't offer any evidence for its claims. It might be helpful to provide a link to a case study.

@kyldvs
Copy link
Contributor

kyldvs commented May 23, 2021

Thanks for the issue! This section is intentionally brief so that the page does not become a novel explaining the values of functional programming. It's meant more of a reminder towards qualities that are beneficial in functional languages, and then if a reader is curious to learn more there are many articles talking about the benefits of these languages a quick search away. If you come across this page you likely already have a sense of the what & why of functional programming in general.

I do agree that we don't do a great job motivating why Reason over other functional programming languages. That's something we could try to improve here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants