reasonml.github.io icon indicating copy to clipboard operation
reasonml.github.io copied to clipboard

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

Open Jazzyboy1 opened this issue 4 years ago • 1 comments

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.

Jazzyboy1 avatar May 23 '21 01:05 Jazzyboy1

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.

kyldvs avatar May 23 '21 04:05 kyldvs