add a few docstings and other minor delint