adding detailed documentation about using the command line API