proposal-pipeline-operator icon indicating copy to clipboard operation
proposal-pipeline-operator copied to clipboard

Text readability

Open bodograumann opened this issue 2 years ago • 2 comments

I feel that the overuse of bold markup in the proposal texts leads to bad readability. Can we remove most of it?

bodograumann avatar Sep 09 '21 14:09 bodograumann

I think this issue belongs in https://github.com/tc39/ecmarkup

jamiebuilds avatar Sep 09 '21 17:09 jamiebuilds

I think they’re referring to the copious use of bolding in the explainer document. That’s my fault; my apologies.

It’s a habit I picked up from Bret Victor in his Scientific Communication as Sequential Art, and it personally makes it easier for me to read dense technical texts, but I understand that it’s a matter of degree, and it might not apply to everyone.

I think it is a reasonable request to reduce—it doesn’t have to be completely removed, just reduced.

But I don’t currently have time to work on going through the entire explainer document and reducing the boldface, sorry. A pull request would be welcome.

js-choi avatar Sep 09 '21 17:09 js-choi