Важно, чтобы учебник был. А потом в него же ( другим цветом текста ) можно добавить недостающие описания. Как комментарии в скриптах.