add coding pitfalls documentation