Fix problems with compiling documentation

Adding test for validating  documentation syntax.