Improved documentation and demos

One demo at least should be expanded.