code cleanup and minor inline documentation
readme updates
make ready for GitHub -> WP repo deployment

These do not go into WP repo
oops