Да, лучше со скриншотами и поясняющими надписями, чтобы программерам долго не вдумываться. Чем быстрее поймут - тем быстрее поправят.
Если уж совсем что-то глобальное, то еще лучше роликами снабжать.