Documentation refactor and spec test information addition

This is a documentation refactor to update some things like usage, syntax, spec tests, etc. @tPl0ch, I made this PR so you could review. If good for you go ahead and merge :thumbsup: