Documentation, tips and pitfalls