add tutorial cross-reference target
add doc for good and bad use cases for Oraide
merge: document good and bad use cases for Oraide

fixes #6
add tox directory to .gitignore
fix heading capitalization inconsistency