Судя по эпичным тредам*, люди не воспринимают не только текстовую документацию, но и доки с картинками.
может, стоит документацию всегда делать в виде видеокастов?
текстовую документацию тоже делать, ссылки на нее давать сабами из видео
(парочка эпичных тредов:
http://www.linux.org.ru/forum/games//5857411
http://www.linux.org.ru/forum/general/6128052
в реальной жизни таких гораздо больше)