I would like to suggest adding some code snippet or pseudo code in each API and marked [in], [out] for each parameter. It will be more clear and helpful for developers.