Fix syntax errors in documentation and update .gitignore

Please, take a look on this.