README: notes about common pitfalls