Add pitfalls.md for documentation of best practices and pitfalls to avoid