documentation updates about client code generation
as requested by [09ae8513eb], [168eb753e5] and [d7e5521da5]
(not finished yet)