documentation - second draft