[CSL-2312] Fill out documentation, fix a logic issue
[CSL-2312] Fill out documentation, fix a logic issue

input-output-hk/cardano-sl,input-output-hk/cardano-sl,input-output-hk/cardano-sl,input-output-hk/pos-haskell-prototype,input-output-hk/pos-haskell-prototype,input-output-hk/pos-haskell-prototype,input-output-hk/cardano-sl