designer fixes, added documentation