точнее UX:)

#вакансия #fulltime #wanted_tw

🔘Технический писатель в Maxima (г. Казань) https://maxima.life/
• опыт работы от 1 года;
• опыт работы в JIRA, Confluence;
• опыт создания пользовательской документации для программных продуктов.


🔘Задачи:  
• Выстраивание процесса работы технического писателя;
• Составление базы знаний проекта;
• Документирование разрабатываемого программного обеспечения;
• Разработка/актуализация пользовательской и сопроводительной документации в рамках текущих релизов;
• Разработка инструкций по внутренним процессам;
• Формирование пользовательской документации по единому шаблону;
• Взаимодействие с командой аналитиков, разработчиков, тестировщиков в процессе разработки документации;
• Оценка сроков и планирование работ.


🔘Мы предлагаем:
• Оформление по ТК РФ;
• Стабильную и достойную заработную плату, соответствующую твоим скиллам (обсуждается индивидуально на собеседовании);
• График работы 5/2 с гибким началом рабочего дня с 08:00 до 10:00;
• Приятный релокационный пакет для специалистов из других городов;
• Курсы по английскому языку;
• Профессиональное обучение и конференции;
• Полис ДМС;
• Комфортный офис класса А;
• Собственный спортзал и кафе.


🔘Контакты: 89274581654.

#wanted_tw #Минск #Беларусь #Job #вакансия #fulltime

Всем привет!)                                                                                          
Awem Games ищет терпеливого и внимательного к деталям Технического писателя, который сможет отобрать главное, разобраться в сложных технических терминах и записать их простым языком. Если у тебя хороший английский, тебя не пугают незнакомые определения, вроде AWS, потому что ты не боишься спрашивать ни у гугла, ни у коллег, то мы ждем тебя.

Вместе с нами ты будешь систематизировать информацию, разрабатывать правила стилистического оформления документов, составлять Meeting Follow up, оптимизировать структуры документов в Confluence. Более подробно можно познакомиться с вакансией https://jobs.tut.by/vacancy/36562727

Что предлагаем: новый комфортный офис в Минске (БЦ Грин Сити), возможность работы в сильной команде специалистов, гибкий график, привязка ЗП к $, долгосрочная перспектива сотрудничества с компанией, которая уже более 18 лет успешно разрабатывает казуальные игры, возможность влиять на развитие продукта напрямую, отлично налаженные процессы.

Люди, работающие в Awem Games, профессионалы, которые умеют делать хитовые проекты. Доказательство этому - наша флагманская игра Cradle of Empires, которая вот уже 5 лет подряд входит в топы среди match-3 игр. Кроме того, игра может похвастаться цифрой в 15 миллионов установок, и активной полумиллионной ежемесячной аудиторией. Но, несмотря на все достижения, мы никогда не останавливаемся.

Спроси меня о подробностях⬇️⬇️⬇️:
e-mail: goncharova@awem.com                
Skype: olga.goncharova1989
LinkedIn: https://www.linkedin.com/in/olga-goncharova                  
или в лс 😉

привет) можете поделится кому какие апи документации нравятся как эталон (по тому как представлена информация)

и не могу найти пример как указывается что определенные параметры  нужно передавать через form_data

документация была всегда самописная, через стили рисуется табличка, свагер будет позже)

Привет, у меня любовь с https://stripe.com/docs/api

Плюсую! Не идеал, но идеала и нет, а это ближе всего к нему

расскажите, что вы любите в доке страйпа?

мне еще нравится, у них как-то очень четко, вопросов не остается
https://sendgrid.com/docs/API_Reference/api_v3.html
https://api.privatbank.ua/#p24/pb

за два года впервые в задании появились новые "сущности" - я так предполагаю они и ранее были, просто до меня никто не добавлял и не просили добавить.

что даже не уверена как это добавляется в апи документацию

тип параметра "файл" (ок, столбец - тип), параметр прикреплен в form-data
вот из всех параметров только про него такое свойство есть.. и как его добавить?

тип параметра "массив объектов", свойство "ID" - свойство "ид" относится к типу, можно в тот столбец и вписать?

то ли я не так ищу в гугле - но что то такой информации не было на курсах ни в гугле особо, разве что уже в учебниках непосредсвенно по языку php, java и прочее

поделитесь опытом пожалуйста :)

Привет. Если бы сейчас потребовалось описывать API, за пример взял бы это: https://pyrus.com/ru/help/api

Все хорошо, но у большинства нет try is out. Т.е. интерактива.

Иными словами - это просто портянка информации. А вся суть API reference как раз и состоит в том, чтобы попробовать и запулять свои параметры. И посмотреть на результат.

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

#wanted_tw #вакансия #удаленно #аналитик #analyst

Город: не имеет значения
Компания: tzprofi.ru

Требуется аналитик\технический писатель, работа удаленно.

Заработная плата от 90 000 рублей\мес.

Обязанности:
1) Рaзрaбoткa прoeктнoй дoкумeнтaции, включaя: тeхничeскиe зaдaния, функциoнaльныe трeбoвaния, спецификации и т. д.
2) Визуализация отчетов, составление презентаций.
3) Сбoр, aнaлиз и учeт трeбoвaний Зaкaзчикa.
4) Оценка и Согласование времени на исполнение задач.
5) Общаться в мессенджерах и иногда голосом.
6) Работать по 3-8 часов в день.

Условия:
- Свободный график работы.
- Формат взаимодействия: удаленная работа.
- Выплата з/п 2 раза в месяц.
- Возможность профессионального и карьерного роста в сфере бизнес аналитики.
- Возможность совмещать с основной работой.

Требования:
- Релевантный опыт работы в техническом писательстве для IT.
- Опыт работы с облачными сервисами.
- Знание русского и английского языка.
- Умение искать и находить информацию в интернете.
- Привeтствуeтся oпыт рaбoты системным администратором
- Целеустремленность, готовность работать в команде и развиваться.
- Приветствуется опыт коммуникаций, активная жизненная позиция.

Контакты: @MassiveSemantic
jobmasssem@gmail.com

Мне ужасно не нравится

оформите по правилам вакансию, пожалуйста) Правила в закреплённых сообщениях

сделал, спасибо

Ну кстати для меня например в API очень важны примеры с curl иногда, так как бывает в той же Jira Cloud API нужно искать в community примеры вызова

Я вот открываю первую попавшуюся страницу
https://pyrus.com/ru/help/api/catalogs#
и вижу
а) полное отсутствие описаний всех ошибочных возвратов (и как мне с этим работать?)
б) совершенно ужасную терминологию:
> Синхронизация справочника (а по описанию - перезапись с условиями)
> Метод обновляет (это синоним синхронизирует?) значения и заголовки справочника. Необходимо передать все значения и текстовые колонки, которые должны остаться в справочнике. (по-моему синхронизация - это когда передается только разница)
> apply. Укажите true если хотите обновить справочник и false если хотите только посчитать, какие элементы будут добавлены/удалены/обновлены. (две минуты бы втыкал, хорошо, что я знаю, что назовут словом apply)

Это не всегда легко сделать с точки зрения доступов/безопасности. Нужно держать какой-то аккаунт с изолированной БД, чтобы никто ничего не поломал.

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