add more pitfalls
add a little warning
add gitignore