Size: a a a

technicalwriters

2020 August 30

D

Denis in technicalwriters
Я слышал, что либре развился и молодец, но единственное, что отталкивало - это медленный джавовый интерфейс ппц
источник

D

Denis in technicalwriters
или Qt, чего там они используют
источник
2020 August 31

ИЕ

Иван Ершов in technicalwriters
Denis
Я слышал, что либре развился и молодец, но единственное, что отталкивало - это медленный джавовый интерфейс ппц
Периодически использую для некоторых задач. В принципе он норм, но есть особенности:
1. Действительно, приложения пакета долго запускаются. Есть встроенный костыль для быстрого запуска.
2. Нормальная проверка грамматики - через дополнение LanguageTool, которое, в свою очередь, требует установленной JRE.
3. В Calc формулы на латнице. Непривычно, если работаешь в русской версии Excel.
4. До сих пор не работает корректно с масштабированием интерфейса Windows: если масштаб отличается от стандартного - иконки кнопок превращаются в мутное нечто.
5. Вроде не совместим с VBA-макросами MS Office
6. Мозг ломается от разницы в интерфейсах MS Office и LibreOffice.
источник

СФ

Семён Факторович... in technicalwriters
Denis
Я слышал, что либре развился и молодец, но единственное, что отталкивало - это медленный джавовый интерфейс ппц
не далее как год назад получали фидбек от клиентов, которые открывали наши сгенерированные DOCX в LibreOffice на линуксе: TOC рассыпается, автообновляемые поля иногда отваливаются, шрифты выглядят чуть-чуть не так
источник

D

Denis in technicalwriters
Эх.. звучит это все так себе, хотя казалось бы, почему гуглдокс умеют, а проект, который вроде как нужен толпе - нет)
источник

NV

Nick Volynkin in technicalwriters
Семён Факторович
не далее как год назад получали фидбек от клиентов, которые открывали наши сгенерированные DOCX в LibreOffice на линуксе: TOC рассыпается, автообновляемые поля иногда отваливаются, шрифты выглядят чуть-чуть не так
Мы скомпилировали ваше приложение на Java c помощью компилятора C# и вот что нам не понравилось...
источник

СФ

Семён Факторович... in technicalwriters
короче, в итоге это всё начало напоминать кросс-браузерную верстку: надо просто помнить, что разные клиенты смотрят разными просмотрщиками, и адаптироваться под это
источник

SO

Svetlana Ozhogina in technicalwriters
#wanted_tw  #Москва #english #fulltime
Срочно нужен тех писатель Revizto для написания документации на англ языке (https://www.linkedin.com/company/revizto/) .
Тысячи пользователей по всему миру.
https://www.youtube.com/watch?time_continue=5&v=y27s9Gwh490
Вилка: 150 000 - 190 000 р (на руки).
Требования:
•Продвинутый уровень английского языка Upper Intermediate/Fluent (разговорный и грамотный письменный);
•Опыт работы техническим писателем от 1 года;
•Умение систематизировать/структурировать информацию, мыслить логически, структурировано излагать информацию;
•Хорошее знание Windows, Author-it, других профильных программ;
•Умение работать в команде, ответственность, стрессоустойчивость.
•Навыки работы в Jira, Confluence;
•Приветствуются знание или представление о программах Autodesk Revit, Navisworks или AutoCAD.

Светлана Ожогина- HR Revizto (s.ozhogina@revizto.com, telegram +79037220510).
источник
2020 September 01

NP

Nikolaj Potashnikov in technicalwriters
Семён Факторович
короче, в итоге это всё начало напоминать кросс-браузерную верстку: надо просто помнить, что разные клиенты смотрят разными просмотрщиками, и адаптироваться под это
Форматы не изоморфные. Это был осознанный выбор безответственных товарищей
источник

NP

Nikolaj Potashnikov in technicalwriters
Единственный выход -- doc as code)
источник

D

Daria in technicalwriters
Привет всем.
У нас есть двуязычная пользовательская документация по сложному продукту. Есть регулярные (примерно раз в две недели) обновления в продукте.
Мы хотим каким-нибудь образом отслеживать все статьи документации, которые требуется обновлять.
Бывает так, что в статье, в которой не ждёшь, обнаруживается устаревший скриншот или какая-то ещё информация.
Наверняка кто-то сталкивался? Как решили?

docs-as-code, md
источник

AD

Alyona Devon in technicalwriters
а как может обнаружится "в статье, в которой не ждешь"?

если обновления продукта или в интерфейсе есть - текст который будешь менять и скриншоты и прочие данные - вполне себе ожидаемые) у нас к примеру 265 статтей, каждая из них мультиязычна - 5 языков, и вот их все один человек знает, так как все писал и публиковал. если что поменялось - где именно поменять и сразу везде. не знаю какой тут может быть алгоритм
если статтей/страниц документации больше - больше людей просто на это обычно.
или в телеграмм бот должен оповещение присылать, а искусственный интеллект анализировать весь текст?
источник

ME

Maria Ermakovich in technicalwriters
Daria
Привет всем.
У нас есть двуязычная пользовательская документация по сложному продукту. Есть регулярные (примерно раз в две недели) обновления в продукте.
Мы хотим каким-нибудь образом отслеживать все статьи документации, которые требуется обновлять.
Бывает так, что в статье, в которой не ждёшь, обнаруживается устаревший скриншот или какая-то ещё информация.
Наверняка кто-то сталкивался? Как решили?

docs-as-code, md
1. камменты в коде (у нас местами прямо линки на сорс доков)
2. automation скриншотов - написать software робот который будет скриншотить одни и те же экраны в приложении и сравнивать с имеющимися скриншотами (это из области фантастики, но видела доклад на тему)
источник

ME

Maria Ermakovich in technicalwriters
3. включение писателей в команды разработки с самых первых этапов - слушать дейлики и смекать
источник

D

Daria in technicalwriters
Alyona Devon
а как может обнаружится "в статье, в которой не ждешь"?

если обновления продукта или в интерфейсе есть - текст который будешь менять и скриншоты и прочие данные - вполне себе ожидаемые) у нас к примеру 265 статтей, каждая из них мультиязычна - 5 языков, и вот их все один человек знает, так как все писал и публиковал. если что поменялось - где именно поменять и сразу везде. не знаю какой тут может быть алгоритм
если статтей/страниц документации больше - больше людей просто на это обычно.
или в телеграмм бот должен оповещение присылать, а искусственный интеллект анализировать весь текст?
> вот их все один человек знает, так как все писал и публиковал

увы, нет. многое писалось другими людьми
источник

KC

Kseniya Chudakova in technicalwriters
Maria Ermakovich
1. камменты в коде (у нас местами прямо линки на сорс доков)
2. automation скриншотов - написать software робот который будет скриншотить одни и те же экраны в приложении и сравнивать с имеющимися скриншотами (это из области фантастики, но видела доклад на тему)
Да, автоматизация скриншотов — это очень круто. Подскажи подробнее про комменты в коде, вы указываете ключ задачи и по нему отслеживаете изменения?
источник

KC

Kseniya Chudakova in technicalwriters
Alyona Devon
а как может обнаружится "в статье, в которой не ждешь"?

если обновления продукта или в интерфейсе есть - текст который будешь менять и скриншоты и прочие данные - вполне себе ожидаемые) у нас к примеру 265 статтей, каждая из них мультиязычна - 5 языков, и вот их все один человек знает, так как все писал и публиковал. если что поменялось - где именно поменять и сразу везде. не знаю какой тут может быть алгоритм
если статтей/страниц документации больше - больше людей просто на это обычно.
или в телеграмм бот должен оповещение присылать, а искусственный интеллект анализировать весь текст?
А как у вас происходит онбординг новых техписателей?
источник

BF

Bobba Fett in technicalwriters
Daria
Привет всем.
У нас есть двуязычная пользовательская документация по сложному продукту. Есть регулярные (примерно раз в две недели) обновления в продукте.
Мы хотим каким-нибудь образом отслеживать все статьи документации, которые требуется обновлять.
Бывает так, что в статье, в которой не ждёшь, обнаруживается устаревший скриншот или какая-то ещё информация.
Наверняка кто-то сталкивался? Как решили?

docs-as-code, md
Девелоперские тикеты. Их можно как минимум мониторить на предмет изменений, а в идеале документирование должно быть таким же этапом в жизни тикета, как тестирование (то есть ни одна фича/баг фикс не может считаться законченным, пока не будет аппрува от писателя)
источник

ME

Maria Ermakovich in technicalwriters
Kseniya Chudakova
Да, автоматизация скриншотов — это очень круто. Подскажи подробнее про комменты в коде, вы указываете ключ задачи и по нему отслеживаете изменения?
нет, всё проще: в камменте прямо написано "доки на эту фичу лежат здесь" и путь к файлу в репе или, прости господи, tinyurl (у нас кастомеры читают конфлюенс). ответственность девелопера, который трогает код - сказать техписателю
источник

ME

Maria Ermakovich in technicalwriters
какие-то доки автоматизированны через документационные модули, например если ты девелопер и добавляешь или удаляешь фичи (DSL, архетипы), то твоя ответственность - обновить include в документационном модуле, из которого в конце спринта генерятся списки фич
источник