extra documentation and little fixes