[WIP] improving documentation

                   
|Q            |A  |
|---          |---|
|Bug Fix?     |n  |
|New Feature? |n  |
|BC Breaks?   |n  |
|Deprecations?|n  |
|Tests Pass?  |n  |
|Fixed Tickets|   |
|License      |MIT|
|Doc PR       |   |
                   


 Sent using [Gush](https://github.com/gushphp/gush)
In this idiom you can't say 'on one hand' without a follow up of something like 'on the other' - it is for comparing alternatives.

"One consequence is.." might be better.