The documentation is also automatically built by Travis which will prevent any syntax errors from sneaking. While I was at it, I also refactored the Travis job into a build matrix (building yabar and generating the documentation run in parallel).
Please review the correctness of the documentation as-is.
@NBonaparte I'm not a fan of huge monolithic commits. IMO commits should be small and logically separate (i.e. the travis change is independent of the the doc change). Just my two cents.
I moved the Yabar documentation to AsciiDoc format. This has multiple advantages:
The documentation is also automatically built by Travis which will prevent any syntax errors from sneaking. While I was at it, I also refactored the Travis job into a build matrix (building yabar and generating the documentation run in parallel).
Please review the correctness of the documentation as-is.