Comment on On Writing WellparentComments−esquivalience2yI found your last paragraph entirely unambiguous at all three levels, which led me to disgree with your overall point. Before that I was with you!−langcss2yThe benefit of "The service is now ready. To check the service's status, ..."Is when someone needs to amend this sentence later, e.g. inserting another point:"The service is now ready. This means you can query the health endpoint. To check the service's status, ..."It makes the writing less likely to become ambiguous.Most documents I see in work will constantly have sentences added/removed as things change.−karmakaze2yMany 'rules' including this one can be broken if you know the tradeoffs and can make the case-by-case choices correctly. But that was a poor example for motivating a behaviour.
Comments
I found your last paragraph entirely unambiguous at all three levels, which led me to disgree with your overall point. Before that I was with you!
The benefit of "The service is now ready. To check the service's status, ..."
Is when someone needs to amend this sentence later, e.g. inserting another point:
"The service is now ready. This means you can query the health endpoint. To check the service's status, ..."
It makes the writing less likely to become ambiguous.
Most documents I see in work will constantly have sentences added/removed as things change.
Many 'rules' including this one can be broken if you know the tradeoffs and can make the case-by-case choices correctly. But that was a poor example for motivating a behaviour.