docs
better example logic