more inline docs
fix up example server, upgrade hygienist