document yaml parameters