:memo: fix badges, add small doc
:lipstick: fix docblocks