Еще есть такая небольшая особенность построения хорошей справки - если предпологать, что нормальный пользователь изучает документацию сверху вниз, то примеры недолжны использовать те элементы, которые пользователь еще не знает к данному моменту. И наоборот - уже изученный ранее сложный элемент можно аккуратно ввернуть в нижестоящие примеры(слои скажем, или менеджеры подсказок, иконок и т.д.)