docs($client/index): add explanation comment on how code works