test scripts to compare mdbook version output

[rbuckland]

This PR adds some BASH scripts that forcibly test 2 configurable branch versions of mdbook with all the rust-lang-nursery/* and rust-lang/* book.toml repos *(finds them via github API search).

The tests/mdbook_version_validator/README.md has a LOT more information.

but in short, these scripts are good for running two separate versions (build by the scripts) of mdbook, and compiling a list of books, and checking for any differences - and reporting.

The scripts are NOT run as part of cargo test, they are just BASH scripts to give some level of confidence for current (smart-preprocessor) and future changes.

This is for PR #658

[Michael-F-Bryan]

This is pretty cool! I imagine they'd be useful when checking for regressions or trying to reproduce an issue.

What are your thoughts on putting the README.md in the user guide under the for developers section? Technically it's for mdbook developers and not developers of 3rd party plugins, but being in the user guide will probably make the scripts more discoverable.

[rbuckland]

Yes - good idea. I will

• - Add a config file, allowing users to add their "books" to the config for searching. (either org or direct repo with book.toml)
• - Add some documentation, making the feature aware so other can register their - dependency / interest

It would be good to rewrite the test as rust - (as an excercise). (later)

[rbuckland]

Am closing this PR, creating a new one from the "test scripts branch"

https://github.com/rbuckland/mdBook/tree/feature/other-books-test-scripts

[rbuckland]

New PR created as #786