Comment by dvdhnt

I understand not everyone will agree, but I find this to be a deficiency of ReasonML compared to strict TS.

Types offer inline documentation to developers that come after you. They should make it easier to establish and maintain a mental model.

Obviously, this requires buy-in from all parties, but if the tool itself doesn't encourage buy-in, it is a bug, not a feature.