added more documentation (bgb)