Consolidate the demo and test_cases folders

[lymereJ]

Having a test_cases and demo folder is confusing, we should probably consolidate them and add the examples to the documentation and integrate them as part of the tests to make sure that subsequent changes to the code base doesn't prevent them from running.