Size: a a a

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

2021 November 01

ВЩ

Владимир Щепин... in Технические писатели
Простите за некропост. Но не, не надо нам такого. Много лет пользуюсь ShareX. Опенсорс, удобнейший захват, легкая редактура после захвата, автоименование йайлов по маске, куча экшенов на автоматическое выполнение, от ватермарков до автозагрузки куда угодно.
источник

AS

Andrei Serikov in Технические писатели
Воля ваша
источник

ВЩ

Владимир Щепин... in Технические писатели
Ну, а я о чем. Не вижу смысл в этих всяких сервисах. Оно еще и платформозависимое, без хрома никуда.
источник

AK

Alik Kurdyukov in Технические писатели
Добрый вечер! Помогите, пожалуйста, советом как правильно организовать написание документации на gRPC API некоторого сервиса. Что есть:
(a) описание контракта этого сервиса на protobuf3 (gRPC)
(b) несколько сотрудников, которые могут подробно рассказать и ответить на вопросы
(с) деньги.
Что хочется получить: документацию на английском, сделанную на reslate или чем-то таком. Чтобы независимый разработчик мог разобраться как использовать API и задавать минимум вопросов.

Попытка привлечь внутреннего контентщика провалилась, поскольку он не разработчик, приходится объяснять все “от Адама”.
Лучше искать фрилансера? Или обращаться в компанию? Стоит ли ждать от внешнего человека понимания чем метод отличается от сообщения или все объяснять?
источник

rK

rJIynbIu` KOT in Технические писатели
мне наоборот красная строка нравится, если нет интервала между абзацами как иначе?
у нас Ворд в пдф, поэтому норм смотрится
как-то руковод хотел и без красной строки и без интервала, а там ещё и по ширине заполнение... но я отговорил)
источник

V

Vaaarya in Технические писатели
У нас есть разрывы между абзацами, плюс это гугл-доки, в печать и пдф не идет
источник

rK

rJIynbIu` KOT in Технические писатели
тогда только сумасшедший там будет делать красную строку)
источник

V

Vaaarya in Технические писатели
Пожалуй, это не буду ему передавать🤣
источник

L

Lana in Технические писатели
Хороший аутсорс техпис/APIсатель уже будет понимать про устройство API, основные протоколы, методы, эндпойнты,и как их тестировать, отправлять и получать запросы, надо будет только немного бизнес-задачу этого API объяснить и все, чтобы он не только референс написал, но и какие-то общие части про как и зачем использовать. Можно попробовать обратиться в documentat.io, если плана нанимать самим или на парттайм нет
источник

G

Grolribasi in Технические писатели
Я писал статьи для selectel. Они, вроде, всегда ищут, так что можно сделать себе портфолио и подзаработать. Пишите в телеграм @dalvius
источник

AK

Alik Kurdyukov in Технические писатели
Спасибо, попробую обратиться 🙂
источник

AN

Anton Novillero in Технические писатели
Спасибо!
источник
2021 November 02

ET

Eduard Tibet in Технические писатели
documentat.io. @factorized обязательно поможет :)
источник

ET

Eduard Tibet in Технические писатели
Да, уже написали  выше - видел :)
источник

X

Xenomorph in Технические писатели
#job Ищу работу. Резюме http://scripsi.ru
Технический писатель, API, системы единого источника, криптография, эквайринг. А так-то про всё можно писать (в плане программного обеспечения). В ГОСТ могу.
источник

MC

Milkhail Che in Технические писатели
Всем привет!
Подскажите, какой сейчас тренд в UX: используют ли  сейчас заголовки в модалках или нет?
источник

MC

Milkhail Che in Технические писатели
Кажется, для разделения текста можно просто использовать два шрифта.
А заголовок сам по себе очень громоздкий.
источник

1

1 in Технические писатели
Добрый день! Подскажите, пожалуйста, пишу в oxygen xml + dita.

Задача:
Нужно в топиках определить свои сущности, через внутренний dtd или внешний, но в любом случае мне, как понимаю, надо прописать декларацию через <!doctype ...> . Пример на скрине ниже.

Проблема:
Но дело в том, что в dita топиках автоматически <!doctype ...> уже вставляется при его создании. Таким образом, когда я второй раз пишу <!doctype ...>, чтобы определить свои сущности или указать ссылку на них, то мне  пишет ошибку, что "Already seen doctype". То есть второй раз его использовать не могу.

Вопрос:
Подскажите, пожалуйста, как определить свои сущности в данной ситуации?

#dita #oxgenxml
источник

1

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

A

A_HR in Технические писатели
#wanted_tw #remote #Казань

Компания: Группа компаний FIX (www.fix.ru)
Вакансия: Технический писатель
Формат: Full-time, удаленно (или Казань)
Локация компании: Казань
Контакты: @A_HRManager

Привет!
Мы ищем специалиста в наш новый FinTech проект.
Важна готовность работать в рамках start-up проекта и выстраивать направление с нуля. И также необходимо знание английского языка (не ниже Intermediate).
В первую очередь задачи будут связаны с созданием внутренней документации и базы знаний проекта.

Если есть вопросы, пишите в лс) буду рада рассказать про нас и вакансию.
источник