adding a little documentation and lint cleanup