Housekeeping: improved docs and build without warnings