composewell / streamly

High performance, concurrent functional programming abstractions
https://streamly.composewell.com
Other
849 stars 63 forks source link

Update descriptions of build flags and the build guide #2716

Open harendra-kumar opened 5 months ago

harendra-kumar commented 5 months ago

All the build flags in streamly (except maybe the has-llvm flag) are development only flags. We can make the flag descriptions more explicit mentioning that end-users should not try those unless they know what they are doing. The flags are unsupported for production use and are only to be enabled if recommended by the developers for a specific case (e.g. debugging something). We can mention this in the build guide as well.

An alternative is to remove the flags before uploading the release to hackage, but it has some downsides:

We should only remove the flags that change the API (dev and use-unliftio as of now).