updated documentation and FAQ