Благодарю!

спасибо за полезную статью)

Плюсую - статья вот прям в тему и очень полезная!

спасибо!

#wanted_tw
Всем доброго дня) В компанию Ingate ищу технического писателя (удаленно).
Задачи:
готовить техническое описание ИТ инфраструктуры;
заниматься подготовкой тендерной документации в части ИТ инфраструктуры.
По всем вопросам обращайтесь @YanaBurlakova

#wanted_tw

📌Компания: Ailet (https://ailet.com/)
📌Вакансия: Технический писатель
📍Формат: Удаленно/Если есть желание-можно работать из офиса
📍Локация компании: Москва (м. Курская БЦ Арма; Технопарк Сколково)
📌full-time.
📧Контакты: @grossanna

💻Чем предстоит заниматься:
•Разработка и обновление внутренней (технической) документации в соответствии с корпоративными стандартами;
•Взаимодействие с разработчиками продуктов, аналитиками, экспертами, тестировщиками и менеджерами проектов.

💼Пожелания к кандидату:
•Опыт разработки технической документации, написания статей или иной работы с текстами от 2 лет;
•Понимание принципов клиент-серверной архитектуры, REST, JSON-RPC;
•Умение читать структуру JSON, XML;
•Понимание принципов работы БД SQL, noSQL;
•Знание принципов и методологий разработки ПО;
•Умение структурировать и систематизировать информацию;
•Умение представить информацию в виде схем, блок-схем.
❕Приоритетно:
•Знание основ программирования, базовое владение одним из объектно-ориентированных языков программирования будет преимуществом;
•Хороший кругозор в сетевых технологиях (протоколы и инфраструктура современного интернета);
•Опыт использования Confluence, YouTrack/Jira (или другой help desk/ task manager);
•Владение английским письменным на уровне не ниже среднего;
•Умение читать код PHP, PYTHON.

🚀Мы предлагаем:
•Работа над интересными международными проектами;
•Возможность профессионального обучения и развития;
•Работа в инновационном центре с развитой инфраструктурой и передовыми технологиями;
•Возможность работать удаленно из любого города страны. Кто желает посещать офис: есть два офиса (центр Мск и Сколково). Если решите посетить офис, то вас ждут сладости, вкусный кофе, мягкие пуфы, настольный теннис, спортзал, бассейн и хорошая атмосфера;
•Работа в проектах с самыми современными технологиями;
•Официальное оформление и з/п.
Дорогие коллеги, просим вас обязательно прикладывать к резюме примеры текстов!

📮Отправляйте резюме: @grossanna /Гросс Анна

#wanted_tw #санктпетербург

Всем добрый день!

🖌Открыта вакансия Технический писатель

Компания: АИСА ИТ-Сервис (www.aisa.ru)
Офис: г. Санкт-Петербург, м. Чернышевская (на данный момент удаленно)
Проект связан с финансами и бюджетными процессами.

Обязанности:
- Написание ЧТЗ, ПМИ, РП
- Написание отчетов, инструкций

Требования:
-Опыт работы на должности технического писателя
-Опыт разработки технической документации
-Опыт работы с ГОСТ 34, 19

Условия работы:
- Работа в офисе, 5 мин. от м. Чернышевская (на данный момент работаем удаленно)
- Оформление по ТК (больничные, отпускные), белая зарплата без задержек
- Заработная плата определяется в ходе собеседования, готовы рассматривать Ваши пожелания
- Курсы английского языка в офисе
- График 5/2

📲Резюме можно направлять мне в ЛС: @nataly_zhuk

Всем доброго вечера! Может быть кто-то подскажет хорошую инструкцию по формированию документации в Postman? Желательно на русском.

Postman для выполнения запросов и тестирования. Как вы собираетесь в нем документацию формировать? Может GraphQL у вас и вы хотите схему скачать?

machine-readable documentation for your API - про это я и спрашивал

Я хотела бы получить вот такой вариант, как на скрине  https://assets.postman.com/postman-docs/Request+details.jpg . Единственно, не понимаю - как из окна Postman просмотра документации коллекции перейти в окно, что на скрине? Подозреваю, что на скрине это уже опубликованная для публичного просмотра дока. Я ошибаюсь? :)

В справке Постман https://learning.postman.com/docs/publishing-your-api/documenting-your-api/ тут как-то непонятно описан этот момент .

я так понял - при открытии коллекции справа в окне Documentation надо нажать ссылку внизу. Пробовали?

После этого справа сверху - Publish и подтвердить публикацию уже на сайте - даст ссылку на сайт документации

Я дошла до Publish и немного опасаюсь тыцкать - не будет ли это открытая публикация для всеобщего просмотра?

Что не хотелось бы )) Клиент съест без соли

да, документация станет досутпна по прямой ссылке. Вероятно даже всем, кто зайдет по ссылке. Но всегда можно будет нажать unpublish. Плюс там есть preview Documentation - еще до окончательной публикации даст посмотреть на нее

Как закрыть доступ (например паролем) - не нашел. Там только есть настройка кастомного домена для публикации. Но я даже не догадываюсь, как это настраивать

Спасибо. В принципе, как и подозревала - то был скрин опубликованной доки. Про возможность unpublish не знала, это вдохновляет :) Буду разбираться дальше.