more documentation, fixed demos