starting slight cleanup and improvement of docs