Общие и закрытые знания
Вся документация Tibbo создаётся с расчётом на краткость. Ни у кого нет времени на раздутые руководства.
Решая, что должно попасть в это руководство, а что нет, я обычно исхожу из принципа «общие инженерные знания или закрытые знания».
К «общим инженерным знаниям» относятся факты, широко известные в инженерном сообществе.
Обычно такие сведения распространяются через Интернет, преподаются в технических учебных заведениях (колледжах, университетах) и считаются частью общепринятой базы знаний специалистов по электронике и информационным технологиям.
Проще говоря, если что-то легко найти в поисковике, результатов много, они приходят из разных источников и в основном согласуются между собой, то это «что-то» относится к «общим инженерным знаниям».
«Закрытые знания», напротив, - это факты, которые исходят от конкретного производителя, например Tibbo.
Пока Tibbo не расскажет о них миру, вы о них не узнаете и не найдёте эту информацию ни в каком другом источнике.
Чтобы объём руководства оставался минимальным, я стараюсь по возможности исключать все «общие инженерные знания».
Азы учить у меня не нужно. Если чего-то не знаете - поищите в Интернете.
Пример:
Допустим, Tibbo выпускает встраиваемый модуль с несколькими линиями ввода-вывода, и эти линии выполнены по технологии CMOS.
Закрытое знание здесь в том, что линии ввода-вывода модуля - типа CMOS. Об этом нужно сказать мне: если я не скажу, узнать это больше неоткуда (разве что гадая или вскрывая устройство методами обратной разработки).
Всё остальное, что можно знать о «линиях ввода-вывода CMOS», - открытые инженерные знания. Я считаю, что в инженерные знания входит общее понимание того, что значит «CMOS». Сюда же относится вся культура работы с линиями CMOS, защиты их от выхода из строя, правильного проектирования изделий с такими линиями и так далее. Объяснять всё это - не моя задача.
Итог: это руководство - не энциклопедия и не школьный учебник. Это краткий источник закрытых знаний Tibbo.
Кажется, чего-то в руководстве не хватает? Сообщите мне! Мой адрес: dima@tibbo.com.