Опыт показывает, что документацию пишут для пользователей, а читают её конкуренты.