new documentation and also a wonderful fix for the demos page