человеческие доки и исполняемые примеры

@JanaVPetrova я подумал и решил, что вообще можно выкинуть отсюда это дурацкое "человекопонятное". И так ясно, что документация для людей. "Предоставляйте документацию" по-моему вполне хорошо передает смысл.