utils: datastructures docs and PEP257 improvements

Follow-up for #2332