update docs around generating clients

@ckarlof r?