fix reorder (name surname)
reorganize documentation
add validation of parameters
move documentation to doc directory
update