Docs revision and new syntax and options explained