Fix problems with compiling documentation

Adding test for validating  documentation syntax.
Merge pull request #7 from michalskalski/master

Fix problems with compiling documentation