readme and doc improvement