add docs; remove some debugging outputs from clients as the final file was too big