doc: clarifications and fixes in Argo programming guide