Size: a a a

technicalwriters

2020 November 27

CV

Cro Vin in technicalwriters
В свежей статье «Как сделать текст легче» на одном популярном ресурсе приводится пример переделки текста из «сложного» в «простой».

Было

Для обновления, нужно временно скопировать файл «Ф» на компьютер с ПО, обновить программой «П» (указать путь к файлу «Ф»), затем скопировать файл обратно на сетевой ресурс. Перед началом обновления, необходимо убедиться в достаточном количестве свободного места на диске, где расположен файл «Ф», – это необходимо для создания резервной копии. Объём свободного места должен быть не менее размера обновляемого файла. Если свободного места недостаточно, программа выведет соответствующее сообщение.

Стало

Обновление

1 Убедитесь, что на диске, где расположен файл «Ф», достаточно места для создания резервной копии.
2 Скопируйте файл «Ф» из сетевого хранилища на компьютер с программой «П»
3 В программе «П» укажите путь к файлу «Ф» и обновите его.
4 Скопируйте обновленный файл «Ф» обратно в сетевое хранилище.

Как бы Вы переделали его и в чем недостаток предложенного варианта в статье?

(Интересен опыт «стилистических» лайфхаков)
источник

MV

Mariya Varenik in technicalwriters
Всем привет! Ищу респондентов для интервью. Хочу поговорить с техническими писателями о вашей работе, востребованности специальности, задачах, сложностях.
В общем поговорить с вами о вас, для этого нужно 30-40 минут

P.S. Изучаю рынок для запуска нового продукта. Напишите мне пожалуйста в лс
источник

DS

Dmitry Soshnikov in technicalwriters
Cro Vin
В свежей статье «Как сделать текст легче» на одном популярном ресурсе приводится пример переделки текста из «сложного» в «простой».

Было

Для обновления, нужно временно скопировать файл «Ф» на компьютер с ПО, обновить программой «П» (указать путь к файлу «Ф»), затем скопировать файл обратно на сетевой ресурс. Перед началом обновления, необходимо убедиться в достаточном количестве свободного места на диске, где расположен файл «Ф», – это необходимо для создания резервной копии. Объём свободного места должен быть не менее размера обновляемого файла. Если свободного места недостаточно, программа выведет соответствующее сообщение.

Стало

Обновление

1 Убедитесь, что на диске, где расположен файл «Ф», достаточно места для создания резервной копии.
2 Скопируйте файл «Ф» из сетевого хранилища на компьютер с программой «П»
3 В программе «П» укажите путь к файлу «Ф» и обновите его.
4 Скопируйте обновленный файл «Ф» обратно в сетевое хранилище.

Как бы Вы переделали его и в чем недостаток предложенного варианта в статье?

(Интересен опыт «стилистических» лайфхаков)
Недостаток, на мой взгляд, не в стилистике, а в отсутствии информации. Чисто стилистически я бы сначала дал вводную из одного короткого предложения "для тех, кто в теме", а затем разжевал бы для остальных.
Мой вариант (с примечаниями в угловых скобках):

"Для того, чтобы произвести обновление, нужно скопировать файл «Ф» на компьютер с ПО, обработать файл с помощью «П» и вернуть обновленный файл «Ф» обратно.
Примерный порядок действий:
1. Необходимо проверить, что на диске, где расположен файл «Ф» <прим.: я правильно понимаю, что на сетевом диске? По логике, речь должна идти о локальном рабочем месте, куда копируется файл – уточнить!>, достаточно места для размещения его резервной копии. При нехватке места программа <прим.: какая?> оповестит об этом в сообщении, операция произведена не будет.
2. Скопируйте файл «Ф» из сетевого хранилища на компьютер с программой «П» <прим.: нужна конкретная папка или не важно, куда? Тогда ремарку об отсутствии места придётся скорректировать>. Откройте его с помощью «П» и произведите обновление <прим.: зависит от интерфейса «П». Если он простой, то этого достаточно, иначе понадобится указание команд или кнопок>
3. Скопируйте обновленный файл «Ф» обратно в сетевое хранилище <прим.: нужно указывать «на место старой версии файла»?>"

И, конечно, вопрос: а что нам мешает обрабатывать "Ф" непосредственно в сетевой папке, если у нас есть RW-доступ?
источник

E

Evgenya in technicalwriters
Dmitry Soshnikov
Недостаток, на мой взгляд, не в стилистике, а в отсутствии информации. Чисто стилистически я бы сначала дал вводную из одного короткого предложения "для тех, кто в теме", а затем разжевал бы для остальных.
Мой вариант (с примечаниями в угловых скобках):

"Для того, чтобы произвести обновление, нужно скопировать файл «Ф» на компьютер с ПО, обработать файл с помощью «П» и вернуть обновленный файл «Ф» обратно.
Примерный порядок действий:
1. Необходимо проверить, что на диске, где расположен файл «Ф» <прим.: я правильно понимаю, что на сетевом диске? По логике, речь должна идти о локальном рабочем месте, куда копируется файл – уточнить!>, достаточно места для размещения его резервной копии. При нехватке места программа <прим.: какая?> оповестит об этом в сообщении, операция произведена не будет.
2. Скопируйте файл «Ф» из сетевого хранилища на компьютер с программой «П» <прим.: нужна конкретная папка или не важно, куда? Тогда ремарку об отсутствии места придётся скорректировать>. Откройте его с помощью «П» и произведите обновление <прим.: зависит от интерфейса «П». Если он простой, то этого достаточно, иначе понадобится указание команд или кнопок>
3. Скопируйте обновленный файл «Ф» обратно в сетевое хранилище <прим.: нужно указывать «на место старой версии файла»?>"

И, конечно, вопрос: а что нам мешает обрабатывать "Ф" непосредственно в сетевой папке, если у нас есть RW-доступ?
Добрый день, думаю стоит убрать запятую в «для того чтобы»)
источник

CV

Cro Vin in technicalwriters
Dmitry Soshnikov
Недостаток, на мой взгляд, не в стилистике, а в отсутствии информации. Чисто стилистически я бы сначала дал вводную из одного короткого предложения "для тех, кто в теме", а затем разжевал бы для остальных.
Мой вариант (с примечаниями в угловых скобках):

"Для того, чтобы произвести обновление, нужно скопировать файл «Ф» на компьютер с ПО, обработать файл с помощью «П» и вернуть обновленный файл «Ф» обратно.
Примерный порядок действий:
1. Необходимо проверить, что на диске, где расположен файл «Ф» <прим.: я правильно понимаю, что на сетевом диске? По логике, речь должна идти о локальном рабочем месте, куда копируется файл – уточнить!>, достаточно места для размещения его резервной копии. При нехватке места программа <прим.: какая?> оповестит об этом в сообщении, операция произведена не будет.
2. Скопируйте файл «Ф» из сетевого хранилища на компьютер с программой «П» <прим.: нужна конкретная папка или не важно, куда? Тогда ремарку об отсутствии места придётся скорректировать>. Откройте его с помощью «П» и произведите обновление <прим.: зависит от интерфейса «П». Если он простой, то этого достаточно, иначе понадобится указание команд или кнопок>
3. Скопируйте обновленный файл «Ф» обратно в сетевое хранилище <прим.: нужно указывать «на место старой версии файла»?>"

И, конечно, вопрос: а что нам мешает обрабатывать "Ф" непосредственно в сетевой папке, если у нас есть RW-доступ?
Спасибо за мнение!

Бросилось в глаза как и Вам, что в авторской версии место проверяют на условном «сервере», а не там, где производят действия. :)
источник

DS

Dmitry Soshnikov in technicalwriters
Evgenya
Добрый день, думаю стоит убрать запятую в «для того чтобы»)
Соглашусь.
источник

MC

Milkhail Che in technicalwriters
Mariya Varenik
Всем привет! Ищу респондентов для интервью. Хочу поговорить с техническими писателями о вашей работе, востребованности специальности, задачах, сложностях.
В общем поговорить с вами о вас, для этого нужно 30-40 минут

P.S. Изучаю рынок для запуска нового продукта. Напишите мне пожалуйста в лс
Скилбокс теперь будет плодить конкурентов. Ууууу !)
источник

MV

Mariya Varenik in technicalwriters
Milkhail Che
Скилбокс теперь будет плодить конкурентов. Ууууу !)
конкурентов кому?)
источник

MC

Milkhail Che in technicalwriters
Техписам, если я правильно понял, вы их планируете тренить?
источник

M

Maeg in technicalwriters
Evgenya
Добрый день, думаю стоит убрать запятую в «для того чтобы»)
Стоит везде сокращать это длинноту до "Чтобы" :)
источник

MS

Maria Shabanova in technicalwriters
Maeg
Стоит везде сокращать это длинноту до "Чтобы" :)
Я тоже везде сокращаю, нафига мне лишние слова)
источник

E

Evgeniia in technicalwriters
слово «производить» тоже лучше использовать по минимуму, оно больше подходит там, где говорится о производстве
источник

СФ

Семён Факторович... in technicalwriters
Mariya Varenik
Всем привет! Ищу респондентов для интервью. Хочу поговорить с техническими писателями о вашей работе, востребованности специальности, задачах, сложностях.
В общем поговорить с вами о вас, для этого нужно 30-40 минут

P.S. Изучаю рынок для запуска нового продукта. Напишите мне пожалуйста в лс
Мария, добрый день еще раз!

Техписательские курсы на Skillbox, которые вы разрабатываете, будут платными или бесплатными?
источник

MS

Maria Shabanova in technicalwriters
А у них есть что-то бесплатное?
источник

MV

Mariya Varenik in technicalwriters
Семён Факторович
Мария, добрый день еще раз!

Техписательские курсы на Skillbox, которые вы разрабатываете, будут платными или бесплатными?
Я еще не разрабатываю курс) я изучаю рынок и пытаюсь понять, можно ли обучить человека стать тех писом, актуально ли это
источник

MV

Mariya Varenik in technicalwriters
Maria Shabanova
А у них есть что-то бесплатное?
есть, вебинары и интенсивы, а также иногда открываем курсы.
Живя в Сибири я училась по бесплатным вебинарам, потому что в моем городе это были вау знания за которые нужно было платить
источник

MS

Maria Shabanova in technicalwriters
Хорошо)
источник

M

Maeg in technicalwriters
Cro Vin
В свежей статье «Как сделать текст легче» на одном популярном ресурсе приводится пример переделки текста из «сложного» в «простой».

Было

Для обновления, нужно временно скопировать файл «Ф» на компьютер с ПО, обновить программой «П» (указать путь к файлу «Ф»), затем скопировать файл обратно на сетевой ресурс. Перед началом обновления, необходимо убедиться в достаточном количестве свободного места на диске, где расположен файл «Ф», – это необходимо для создания резервной копии. Объём свободного места должен быть не менее размера обновляемого файла. Если свободного места недостаточно, программа выведет соответствующее сообщение.

Стало

Обновление

1 Убедитесь, что на диске, где расположен файл «Ф», достаточно места для создания резервной копии.
2 Скопируйте файл «Ф» из сетевого хранилища на компьютер с программой «П»
3 В программе «П» укажите путь к файлу «Ф» и обновите его.
4 Скопируйте обновленный файл «Ф» обратно в сетевое хранилище.

Как бы Вы переделали его и в чем недостаток предложенного варианта в статье?

(Интересен опыт «стилистических» лайфхаков)
не знаю про стилистику, но ошибка, скорее всего, в описании. Избыточное понятие "резервная копия". Резервной она была бы, если б было две копии: одна обновлялась, а другая - нет. Ну и ставлю на то, что перед копированием места должно быть в 2 раза больше, чем размер файла.
источник

CV

Cro Vin in technicalwriters
Maeg
не знаю про стилистику, но ошибка, скорее всего, в описании. Избыточное понятие "резервная копия". Резервной она была бы, если б было две копии: одна обновлялась, а другая - нет. Ну и ставлю на то, что перед копированием места должно быть в 2 раза больше, чем размер файла.
Спасибо за мнение!

Определенно из информации в первоначальном абзаце «судьба» копии файла туманна).
Возможно, программа создает такие резервные копии и они складируются локально.

В дополнение к Вашим акцентам.
В версии, которую предлагает автор, про «сообщения о ошибках» ничего не сказано.
источник

ЛC

Лера Cоболева... in technicalwriters
#wanted_tw #ТехническийПисатель #TechnicalWriter #English #remote

Компания: Moeco https://moeco.io/
Занятость: full time
Формат работы: remote
Зарплатная вилка: 2000 - 3000 usd Net

Компания Moeco в поисках ведущего Технического писателя с возможностью полностью удаленной работы.

🔶Moeco -  немецкая высокотехнологичная компания, занимающаяся разработкой IoT платформы, для трекинга различных устройств через Bluetooth.
Также Moeco - это распределенная команда молодых и активных профессионалов, чей продукт помогает многим пользователям в США, Азии и Европе отслеживать то, что им важно: от транспортной инфраструктуры до перемещения потерявшихся животных.

🔸Чем необходимо будет заниматься:
Сейчас команда находится в поисках опытного Технического писателя, которому они доверят с "0" структурировать и построить систему внутреннего и внешнего документирования Moeco.

С точки зрения внутренней документации: на текущий момент вся документация ведется в рамках Confluence, пилотов внутри компании становится все больше, и у руководства есть желание систематизировать внутренние процессы и создать полноценный гайд документации, который поможет любому новичку легко разобраться в технических составляющих проекта.

С точки зрения внешней документации необходимо стандартизировать продукты, изучить описания конкурентов и составить систему пользовательских инструкций, которая поможет любому новому клиенту легко вникнуть в продукт Moeco.

🔸Какой опыт и навыки необходимы:
- опыт написания технической документации от 2 лет и более;
- навыки написания грамотных и хорошо структурированных технических текстов, владение английским языком (B2-C1), так как вся внешняя документации будет ориентирована на зарубежный рынок;
- опыт выстраивания документации на проекте с "0";
- большим преимуществом будет бэкграунд в аналитике или технический опыт.

🔶В свою очередь компания предлагает:
- высокую заработную плату (выплаты в долларах);
- возможность удаленно работать из любой точки мира с гибким началом рабочего дня;
- компенсацию посещений профильных конференций; выставок и прочих мероприятий и международных стажировок;
- а также крутую возможность принятия участие в создании мирового продукта в команде профессионалов своего дела!

Контакты:
e-mail: valeriya@luckyhunter.io
telegram: @sobolevavalery
Буду рада ответить на все вопросы и комментарии по вакансии 😊
источник