Size: a a a

technicalwriters

2020 December 10

FM

Fox Mulder in technicalwriters
Более того, орган сертификации не принимает ничего иного окромя docx.
источник

FM

Fox Mulder in technicalwriters
А еще орган сертификации пугают такие слова, как docker-контейнер
источник

TS

Timur Snytkin in technicalwriters
Asya Tyan
Для сертификации ПО не нужна документация по ГОСТ
Во ФСТЭК нужны ТУ и Формуляр по ГОСТУу минимум
источник

AT

Asya Tyan in technicalwriters
Мы сертифицировались без госта несколько раз и достаточно было pdf
источник

FM

Fox Mulder in technicalwriters
Asya Tyan
Мы сертифицировались без госта несколько раз и достаточно было pdf
У меня прям прописаны гост, которые необходимо соблюдать )
Всё это в утверждённых нормативных документах фстэк.
источник

СФ

Семён Факторович... in technicalwriters
Fox Mulder
Я тут, на кофе-брейке, посмотрел вакансии на hh.ru
Исключая чисто международные компании или компании, которые вышли на международный рынок (JB) - только 1 компания подчеркнула, что она  против гост и ворда.
В остальных случаях стоят требования по ворду и гост.
у нас тоже ГОСТ не требуется:) https://novosibirsk.hh.ru/vacancy/40131738
источник

MC

Milkhail Che in technicalwriters
Lana
мне кажется - это была бы киллер фича, только компаниям нужно будет указывать требования как отдельные строки, вроде метаинформации
Есть же теги навыков или как-то так.
источник

L

Lana in technicalwriters
Milkhail Che
Есть же теги навыков или как-то так.
ну навыки и требования не всегда совпадают, навыки вроде кстати указывает только соискатель, но я не уверена, но суть та же - только работодателю нужно прописывать требоввания отдельными строками, чтобы соискатели по ним фильтровали
источник

MC

Milkhail Che in technicalwriters
Fox Mulder
У меня прям прописаны гост, которые необходимо соблюдать )
Всё это в утверждённых нормативных документах фстэк.
И как вы из asciidoc в Гостовский docx перегоняете?

Интересует не сам формат, а структура документа.
источник

ДЧ

Дарья Чернавина... in technicalwriters
Milkhail Che
Ребята, нид хелп!
Помогите найти материал, в котором говорилось, что не стоит равняться на совсем глупых пользователей при написании документации, что это только усложняет её для понимания обычными пользователями.
Могу опять скинуть свой диссер)
источник

FM

Fox Mulder in technicalwriters
Milkhail Che
И как вы из asciidoc в Гостовский docx перегоняете?

Интересует не сам формат, а структура документа.
Сейчас никак, пишу в наитивном ворде )))
А так есть плагин к аски гостовый. Его правда надо допиливать. Он автоматом гонит
источник

ДЧ

Дарья Чернавина... in technicalwriters
Jaroslaw Martinow
Попробуйте поискать информацию по запросу documentation mininalism.

Как пример, вот статья: https://everypageispageone.com/2013/07/02/what-is-minimalism/

В двух словах суть такая:

- к документации обратится скорее опытный пользователь, а неопытный даже не догадается;

- если пользователь настолько неопытный, что ему требуется инструкция по использованию мыши, то от слишком подробного руководства он испытает когнитивный перегруз и вообще откажется читать.
Я тоже пришла к выводу, что неопытный пользователь в случае страха перед системой/устройством скорее будет склонен обратиться к опытному пользователю "тыжпрограммисту". А вот уже опытный, но незнакомый с конкретным устройством — возьмёт в руки инструкцию. Но тут, правда, вопрос в причине и следствии, потому что инструкции зачастую тоже сложны, они не могут объяснить вопрос так же индивидуально, человечно, разжевав и положив в рот, как "тыжвнучек/тыжпрограммист". Поэтому нет никакого смысла прибегать к этому этапу, лучше сразу искать опытного.
источник

MC

Milkhail Che in technicalwriters
Дарья Чернавина
Могу опять скинуть свой диссер)
кидайте)
источник

AS

Anton Samarin in technicalwriters
Fox Mulder
Если речь про собес на фронта, то просмотр данных видео помогает лучше понять объем знаний именно для фронта.
А так как техпис, который не пишет по гост, куда ближе к коду и разработчикам, то наступает такой момент, когда он должен замещать джуна-фронта как минимум.
Дальнейший профессиональный рост техписа зависит личных потребностей )
Личный опыт : работал в четырёх компаниях, в первых двух был Ворд, нигде не было ГОСТа , джуна-фронта ни разу не замещал. Было всё что угодно -  SQL, Dynamics, куча линуксового софта - но работать фронтом не приходилось.
источник

FM

Fox Mulder in technicalwriters
Anton Samarin
Личный опыт : работал в четырёх компаниях, в первых двух был Ворд, нигде не было ГОСТа , джуна-фронта ни разу не замещал. Было всё что угодно -  SQL, Dynamics, куча линуксового софта - но работать фронтом не приходилось.
Антон, я как-нить выборку по hh сделаю, сколько вакансий требуют ворд и гост. )
Что же касается фронта - ну вот, я сейчас придумываю методологию управления конфигурацией разработки.
Тут вопрос в кадрах. Если за командой техписов закреплён разраб, девопс, аналитик, то сиди и пиши тексты.
А если никого нет, то будь бобром тогда.
источник

AS

Anton Samarin in technicalwriters
Fox Mulder
Антон, я как-нить выборку по hh сделаю, сколько вакансий требуют ворд и гост. )
Что же касается фронта - ну вот, я сейчас придумываю методологию управления конфигурацией разработки.
Тут вопрос в кадрах. Если за командой техписов закреплён разраб, девопс, аналитик, то сиди и пиши тексты.
А если никого нет, то будь бобром тогда.
Согласен, но большинство вещей осваиваются только по ходу работы, а не заранее перед её началом.
источник

AS

Anton Samarin in technicalwriters
Ибо к началу они уже просто забываются
источник

AS

Anton Samarin in technicalwriters
При этом в 100% вакансий требуется хороший навык письма
источник

AS

Anton Samarin in technicalwriters
И вот без него не возьмут на работу точно
источник

FM

Fox Mulder in technicalwriters
Смех смехом, но я еще ни разу не работал в компаниях, где были поставлены процессы документирования на должном уровне.  )
источник