Size: a a a

Технические писатели

2021 December 16

А

Андрей in Технические писатели
+
источник

X

Xenomorph in Технические писатели
с жирой потому что, менеджеры думают про производительность и таски, а про конкретные инструменты исполнителей не очень думают.
источник

X

Xenomorph in Технические писатели
примерно так я полагаю
источник

I

Inora in Технические писатели
Коллеги, есть тут кто-нибудь, кто пишет документацию по ГОСТ 18675-2012? Нужна помощь)
источник

M

Maeg in Технические писатели
в любом непонятном случае ставьте плагин для просмотра сорс кода, типа этого - https://marketplace.atlassian.com/apps/1210722/confluence-source-editor?hosting=server&tab=overview
источник

M

Maeg in Технические писатели
при некоторой привычке вообще оттуда можно писать
источник

SR

Stas Rychkov in Технические писатели
Беда в том, что чаще всего приходится делать только так...
источник

M

Maeg in Технические писатели
ну нет. Если использовать конфу по основному назначению - как базу знаний, и если наделать кучку шаблонов на основные случаи жизни, то обычный пользователь никогда проблем не испытает.
Проблемы иногда могут быть если пытаться сделать документацию со сложной разметкой - но это мало у кого "чаще всего". Возможно, стоит слегка порезать пожелания по оформлению, и всё станет проще.
Ну или вы уже написали кучу своих плагинов и макросов, но тогда это точно не проблема конфы. В основе это довольно простой инструмент.
источник

SR

Stas Rychkov in Технические писатели
Один сброс состояния в режиме редактирования чего стоит.

https://jira.atlassian.com/browse/CONFSERVER-28352

Посмотри на версию там. У нас 7.х

И стало только хуже (copy-paste простой работает как драндулет моей бабушки).

У меня, если чё, Silver status на официальном форуме. Догадайся с трёх раз, как я его получил. :)
источник

M

Maeg in Технические писатели
"pages using the section / columns macro seem to be very sensitive to this problem". Понаставят разметку как будто у них веб-сайт... Нормальному бабушкиному драндулету не нужны эти секции, вот что я скажу, Они в принципе в буфер вдвоём не влезают. Надо столбцы - сделайте таблицу со скрытыми границами (ворчит на бабушкинском)
источник

SR

Stas Rychkov in Технические писатели
Согласен. Но если важна гибкость, а масштабируемость --- не основной критерий, следует внимательно отнестись к выбору.

This ain't no silver bullet.

Есть запросы с бородатых годов. И их никто не решает. То есть проблема стала твоей проблемой. Это хорошо видно, если изучить официальный трекер.
источник

SR

Stas Rychkov in Технические писатели
Пример с конфой. Копируем код в storage-представлении с одной страницы на другую. Через вот этот Source Editor. Скачиваем с оригинальной страницы архив вложений. Копируем на целевую страницу эти вложения. И... Они не подтягиваются на целевой странице. Конфа пишет, что файл не найден. Вопрос: почему?
источник
2021 December 17

BN

Baharev Nick in Технические писатели
Коллеги, как включить подсветку кода для asciidoc в VSC? Плагин AsciiDoc установил, но безуспешно.
источник

V

Vasiliy in Технические писатели
возможно vscode по расширению файла не может понять, какую подсветку использовать
источник

BN

Baharev Nick in Технические писатели
расширение по умолчанию .adoc, у меня тоже все файлы в этом формате.
источник

SM

Stanislav Matushevic... in Технические писатели
Всем привет 🙋 подскажите вопрос по цене. Сколько стоит работа технического писателя?

Например, у меня заказали инструкцию к софту.
Писать в Google docs,
скриншоты в удобном сервисе.
Без публикации.

Сколько стоит такая работа? И как происходит ценообразование?
источник

SM

Stanislav Matushevic... in Технические писатели
Спасибо откликнувшимся
источник

D

Dmitriy in Технические писатели
Мы раньше тут это уже обсуждали, и как мне кажется сошлись на мнении, что расчёт начальной цены делается исходя из время × почасовая ставка. Время же берётся как часов на X знаков текста либо «авторских листов».
источник

VI

Vladimir Izmalkov in Технические писатели
Работа может стоить по-разному. Оценить лучше стоимость рабочего времени специалиста. Конкретный специалист по идее имеет ориентир стоимости своего времени (условная стоимость часа работы).
Дальше конкретная задача может иметь отклонения (множители) за срочность, сложность, по результатам переговоров сторон (скидка или бонус).
Условно оклад специалиста делим на около 160 часов в месяц и получаем примерную стоимость часа работы. Остальное - в результате переговоров.
источник

АМ

Александр Матросов... in Технические писатели
Тоже самое хотел написать) плюсую)
источник