Size: a a a

technicalwriters

2021 June 04

СФ

Семён Факторович... in technicalwriters
разным читателям важно разное

в пользовательской документации, зачастую, технические детали не нужны

а есть еще вайтпейперы, маркетинговые документы, документы для безопасников
источник

СФ

Семён Факторович... in technicalwriters
я к тому, что важно сначала понять, кому документация адресована и какие задачи решает, а потом уже задаваться вопросами, какие детали слишком мелки для читателя, а какие нет
источник

FM

Fox Mulder in technicalwriters
Согласен. Полностью.
Но я писал применительно к обычному потребителю продукта.
Ему точно не нужно знать из какого кол-ва точек строится модель лица для face id.
Не все любят читать техническую литературу.
источник

СФ

Семён Факторович... in technicalwriters
я просто не отследил, как дискуссия перешла к Face ID, но стриггерил именно на это, т.к. я на некоторых семинарах детально разбираю iOS Security Whitepaprer, именно с точки зрения «зачем тут описана эта деталь и почему именно с таким уровнем глубины»
источник

АА

Анна Анна in technicalwriters
Коллеги, возник вопрос,  если уже продукция выпускается и в покупные изделия добавился монитор, клавиатура, мышь, нужно ли проводить типовые испытания и заново сертифицировать изделие?
источник

FM

Fox Mulder in technicalwriters
Можно побыть занудой? ))
К телефонам Apple поставляется только шнур )
Значит яблочные ожидают, что пользователь сам должен как-то научиться взаимодействовать с телефоном )
источник

BF

Bobba Fett in technicalwriters
Классический вопрос не только в русскоязычной среде, хотя для английского хотя бы более-менее устоявшиеся стайлгайды есть. Но вопрос всё равно интимный до уровня “как лучше сексом заниматься”. Как не сложно догадаться по ответам, важен контекст, цели, аудитория. Ровно так же как рекомендации в вопросах соития будут абсолютно разными у врача репродуктолога, опытного порно-актёра и школьника любителя вписок, так и тут, к вопросу написания можно подходить с разных сторон.

Например, первым делом можно подумать о том, как бы вы словами сказали своему типичному пользователю. Что вы ожидаете ваш пользователь поймёт с большей вероятностью. Достаточно ли ему просто предложить нажать или нужно пояснить, что нажимать нужно мышкой? Левой кнопкой мыши? Навести курсор и произвести единичной нажатие на левую кнопку манипулятора типа мышь? Возможно, как тут предложили, нужно пояснить это один раз, а потом использовать короткую форму?

Далее, нужно учитывать, есть ли в компании рекомендации соответствовать каким-то внутренним или внешним стандартам и гайдлайнам, или если есть прямые требования, вроде соответствия ГОСТам.

Наконец, насколько вы радеет за “чистоту” языка и культурологические особенности/реалии. Ведь языки - это не только про смысловое соответствия одних слов другим. Тут важны особенности восприятия. В данном случае, вы можете пойти по пути “‘нажать’ в русском языке - это универсальное слово” и лепить его для всего. Можете оглядываться на принятые в английском различия между press, click и tap, и использовать соответствующие им “нажать”, “щелкнуть” и “коснуться” (прикоснуться?). А можете транслитерировать, если вы уверены, что вашим ЮЗЕРАМ будет понятнее КЛИКАТЬ и ТАПАТЬ.

Главное, как и в сексе, чтобы все удовольствие получили. И от написания и от прочтения.
источник

FM

Fox Mulder in technicalwriters
Мне нравится ваша неожиданная пятничная интерпретация )
источник

AC

Alec Chakenov in technicalwriters
Опять все к сексу свели :)
источник

ДЧ

Дарья Чернавина... in technicalwriters
Как говорится, вам нравится трогать или нажимать.
источник

AC

Alec Chakenov in technicalwriters
Ой, всё :)
источник

BF

Bobba Fett in technicalwriters
У меня просто давно не было… документации на русском
источник

L

Luiza in technicalwriters
Пишем нажать на кнопку - если это в интерфейсе Ок, закрыть и т.п.,если физическая, клавиатура, мышь то нажать кнопку ctrl, без предлога
источник

DN

Daria Nikonova in technicalwriters
Добрый день! Может кто-нибудь подсказать, как правильно разбить диаграмму деятельности на несколько частей? Можно ли это сделать с помощью таких точек, например?
источник

L

Luiza in technicalwriters
Нет, если не влияет на функционирование объекта, прошедшего сертификацию, считайте это доп оборудованием комплекта
источник

L

Luiza in technicalwriters
Переслано от Анна Анна
Коллеги, возник вопрос,  если уже продукция выпускается и в покупные изделия добавился монитор, клавиатура, мышь, нужно ли проводить типовые испытания и заново сертифицировать изделие?
источник

FM

Fox Mulder in technicalwriters
Аттестовывать точно надо. Так как параметры электромагнитных излучений могут поменяться. А вследствие этого, радиус зоны ПДТР может увеличиться.
Про сертификацию тоже самое. Если ваш РАМ идёт в сборе, есть наклейки ФСБ, то менять комплектность не позволяется.
Написанное выше - для 4 УД и ниже.
источник

АА

Анна Анна in technicalwriters
Так они же покупные и на них есть сертификаты
источник

FM

Fox Mulder in technicalwriters
сертификат на комплект. Вы не имеете права менять даже мышь.
источник

FM

Fox Mulder in technicalwriters
Если мышь сломалась, вы обязаны отослать весь комплект на повторное прохождение сертификации
источник