- better inline docs, part #5 and presumingly the last major one