improve inline docs