fix/improve docs
implement $maybe_base

always correct?
how do you know without tests L O L