orchestrator: update code comments