refactor markdown files
add some points