tidy and sort doc
add warning for me
add tags
add links