finished first pass at documenting and polishing the tools