AS
Кстати, как вариант, пообщаться с ребятами из wtd. Там проф англоязычное сообщество.
Хорошая идея, благодарю вас. Если найду там что-то , то напишу об этом
Size: a a a
2020 December 25
H
И до Докеров с Жаваскриптами я хочу научиться классно, вкусно писать технические тексты на английском. Как это делает мой коллега Джон.
Здесь ещё субъективная оценка. Может Вы и пишете здорово и при этом кому-то непонятно или вовсе так не нужно. Достаточно, чтобы простыми словами чуть донесли. И порядок.
Зависит ещё от аудитории, для которой пишете и обратной связи.
Зависит ещё от аудитории, для которой пишете и обратной связи.
H
Две стороны медали: можно быть МухаммедКручеВсехБрюсЛи и при этом получать негативную обратную связь от пользователей.
L
Опять же, ephemeral port :)
От ephemeral port спасает вычитка доки разработчиком. По этой же причине надо знать хотя бы основы предметной области.
Вот выше обсуждали, что от техписа требуется быть джун-девелопером. Если техпис пишет для программистов, то да. Уметь написать пример, не облажаться в терминологии - это то, что требует от техписа дополнительных скиллов кроме умения структурировать информацию и писать грамотный текст
Вот выше обсуждали, что от техписа требуется быть джун-девелопером. Если техпис пишет для программистов, то да. Уметь написать пример, не облажаться в терминологии - это то, что требует от техписа дополнительных скиллов кроме умения структурировать информацию и писать грамотный текст
JM
Е Е
А потом открываешь инструкцию к сварочному аппарату, а там одни ямбы с хореями 🤣
1. Распакуй наш аппарат - поработать будешь рад.
2. Ручку в ручку ты бери.
3. Швы ровнее всех вари!!
2. Ручку в ручку ты бери.
3. Швы ровнее всех вари!!
AS
Здесь ещё субъективная оценка. Может Вы и пишете здорово и при этом кому-то непонятно или вовсе так не нужно. Достаточно, чтобы простыми словами чуть донесли. И порядок.
Зависит ещё от аудитории, для которой пишете и обратной связи.
Зависит ещё от аудитории, для которой пишете и обратной связи.
Согласен, но до определенного момента. Если стараться часто обходиться без проф.терминов, которые понятны аудитории, то тоже не очень хороший путь.
AS
От ephemeral port спасает вычитка доки разработчиком. По этой же причине надо знать хотя бы основы предметной области.
Вот выше обсуждали, что от техписа требуется быть джун-девелопером. Если техпис пишет для программистов, то да. Уметь написать пример, не облажаться в терминологии - это то, что требует от техписа дополнительных скиллов кроме умения структурировать информацию и писать грамотный текст
Вот выше обсуждали, что от техписа требуется быть джун-девелопером. Если техпис пишет для программистов, то да. Уметь написать пример, не облажаться в терминологии - это то, что требует от техписа дополнительных скиллов кроме умения структурировать информацию и писать грамотный текст
Да, но это не всегда помогает. Бывает такое, что контент проходит несколько ревьюеров, а через полгода обнаруживают, что в нём ошибки
H
Согласен, но до определенного момента. Если стараться часто обходиться без проф.терминов, которые понятны аудитории, то тоже не очень хороший путь.
Само собой. Я в общих чертах обрисовал, не имел в виду отсутствия.
Безусловно, без специфических терминов никуда.
Безусловно, без специфических терминов никуда.
H
Да, но это не всегда помогает. Бывает такое, что контент проходит несколько ревьюеров, а через полгода обнаруживают, что в нём ошибки
Какого рода ошибки?
AS
Само собой. Я в общих чертах обрисовал, не имел в виду отсутствия.
Безусловно, без специфических терминов никуда.
Безусловно, без специфических терминов никуда.
Да, конечно. Это ещё один приём, который можно использовать в работе
AS
Какого рода ошибки?
Процедура не выполняется, если в неё передать конкретный параметр, который описан словами
H
Ну это серьёзно.
H
Надо не только вычитывать, а ещё и проходить по шагам.
AS
От ephemeral port спасает вычитка доки разработчиком. По этой же причине надо знать хотя бы основы предметной области.
Вот выше обсуждали, что от техписа требуется быть джун-девелопером. Если техпис пишет для программистов, то да. Уметь написать пример, не облажаться в терминологии - это то, что требует от техписа дополнительных скиллов кроме умения структурировать информацию и писать грамотный текст
Вот выше обсуждали, что от техписа требуется быть джун-девелопером. Если техпис пишет для программистов, то да. Уметь написать пример, не облажаться в терминологии - это то, что требует от техписа дополнительных скиллов кроме умения структурировать информацию и писать грамотный текст
Да, и этому тоже нужно где-то учиться. Не с джунской же скамьи убегать в техписатели
AS
Надо не только вычитывать, а ещё и проходить по шагам.
Да, конечно, это и было сделано. Тем не менее, даже это не уберегло от ошибки
H
Но здесь другой вопрос, сколько на это времени нужно и готов ли бизнес к настолько тщательному тестированию документации.
H
Время-то оплачивать нужно.
H
Ну и сроки сдачи увеличатся.
H
От ошибки никто не застрахован.
AS
Постоянное улучшение документации - это естественный процесс. Но в любом случае хочется расти над собой.