Update graphite doc for common pitfalls

A pretty thorough explanation I guess ;-)
Feel free to suggest a more concise format. IMHO the whole story needs to be written down once (I guess even this is not the whole story though...).