some tweeks and documentation