document the initialize method in client to understand doc flow