Комментарии 11
Oscillator в таком случае тоже никак не генератор, а - следуя устоявшейся советской/российской терминологии - резонатор.
Вроде "кварцевый резонатор" или просто "кварц"
Я пользуюсь ГОСТ 22866-77 Генераторы кварцевые. Термины и определения https://docs.cntd.ru/document/1200015736
Кварцевый генератор (Crystal oscillator) Генератор переменного напряжения, стабилизирующим элементом частоты которого является кварцевый резонатор или пьезоэлемент
ГОСТ Р МЭК 60122-1-2009 Резонаторы оцениваемого качества кварцевые
2.2.7 кварцевый резонатор (crystal unit): Пьезоэлектрический резонатор, смонтированный в корпус, основным элементом которого является кварцевый кристаллический элемент.
Вы занялись довольно неблагодарной темой - сортировкой людей на профессионалов и любителей по признаку следования ГОСТам. Пример с "хрустальным осциллятором", вероятнее всего, вообще машинный перевод, а не ошибка в терминологии.
Собственно, я так и не понял, какое отношение сортировка по стилю изложения имеет к объяснению вашего личного отношения к туториалам (которые писать не имеет смысла по многим причинам, тут я с вами совершенно согласен).
Я - любитель. Я не пишу tutorials. Я пишу HowTo's
С "хрустального осциллятора" поржал от души, спасибо :)
По поводу любителей и "Дарлингтона": тут скорее любитель в плане перевода, а не самой темы инструкции.
Есть професионалы своего дела, но которые просто могут быть любителями в плане перевода терминов на русский язык.
В статье смешалось тёплое с мягким: заголовок о написании туториалов (aka мануалов, документаций, руководств), а текст - про нелюбовь автора к написанию их по ГОСТам.
По сути стиль написания инструкций зависит от сферы деательности компании и необходимости в этих самых ГОСТах. Ведь если нет задачи попасть в реестр Минсвязи и компания не работает с госконторами, то и нет необходимости придерживаться вообще каких-то ГОСТов. Пишите как нравится и чтобы было понятно клиентам. Можно даже с некоторой долей юмора, если позволяет корпоративная этика и специфика продукта?
Лично у меня по опыту приходилось писать и ближе к ГОСТам, и попроще - ближе к народу. Ну и опять же, лучше в случае крупных продуктов разделять инструкции к ним и статьи об их использовании в различных ситуациях с подробными примерами.
Любую свою публикацию я могу превратить в «туториал», переписав её согласно требованиям, и сократив раза в три таким образом.
А как статьи на Хабр писать - на самом же Хабре уже сломано миллионы копий и написаны десятки статей.
Отдельная боль, это ГОСТы с индексом "В", и приписка "ВП" в ТУ...
Почему я так не люблю писать туториалы