Size: a a a

technicalwriters

2021 July 22

ТФ

Таня Фокина... in technicalwriters
Тогда можно уйти в софистику и уточнить, «остались» ли сломанные яйца. И сколько времени прошло после съедения (если немного, эти яйца тоже ещё существуют, просто в другом агрегатном состоянии)
источник

BL

Bo Larson in technicalwriters
точно, ты прав
источник

V

Vyacheslav in technicalwriters
тоже верно
в общем, решение задачи одно - отдать ее обратно тому, кто её написал, на доработку условий)
источник

AD

Alyona Devon in technicalwriters
привет всем) а можете ответить для статистики или может у вас есть еще доп источник где можно подробнее изучить (пока выходит только смотреть как у других или спрашивать как делают другие)

вот описание успешных статусов должно говорить что получишь или там просто "Успешный запрос"
и в get методах лучше писать "возвращает .." или "показывает .."

я сколько уже их пересмотрела, и так и так в общем бывает. интересно как лучше все таки)
источник

O[

Olga [olgademoscu] in technicalwriters
@elen_devon Опечатку нашла. 😅
Мне лично больше нравится "возвращает".
источник

NJ

Natalia Jones in technicalwriters
чуток добавлю к флуду )

в молекулярном плане все яйца остались и никуда не делись, просто молекулы существуют в другом окружении/состоянии.

"Мы все сделаны из звездной пыли" (с)
источник

MC

Milkhail Che in technicalwriters
Обычно пишут "Возвращает"
источник

ЕБ

Елена Борисенок... in technicalwriters
Коллеги, порекомендуйте курсы системных аналитиков. Не БА, а именно СА. Хочу поднять квалификацию в смежной отрасли.
источник

V

Vasiliy in technicalwriters
Возможно в этом чате могут помочь: https://t.me/itsysdes
источник

ЕБ

Елена Борисенок... in technicalwriters
спасибо )
источник

E

Evgenya in technicalwriters
Коллеги, добрый день. Стоит задача описать API, никогда этого не делала. Поделитесь шаблоном (если есть такой) или образцами?
источник

АЕ

Алёна [в отпуске] Ел... in technicalwriters
Привет! Есть вот такой интересный курс по API: https://idratherbewriting.com/learnapidoc/ Тут же можно найти примеры документов (например, в видео).
источник

E

Evgenya in technicalwriters
Отлично, спасибо!
источник

А

Андрей in technicalwriters
Коллеги, добрый вечер! Подскажите, появилась ли замена  РД 50-34.698-90 ? Или по-прежнему четкой замены нет, но есть логика 34 серии для АС и др. действующие документы этой серии.
источник

АС

Анастасия Степанова... in technicalwriters
Добрый вечер! Увы замены нет
источник

А

Андрей in technicalwriters
Спасибо!
источник

LL

Lena Lena in technicalwriters
можете еще это посмотреть https://starkovden.github.io/api-reference-tutorial-overview.html
источник
2021 July 23

ET

Eduard Tibet in technicalwriters
Тут надо знать еще какой именно API. Ибо практически все присутствующие здесь, когда говорят об API имеют в виду имено REST. А API это не равно REST. Т.к. второе является только подмножеством первого.
источник

T

Tatiana in technicalwriters
Вот такое еще было, товарищ описывает апи в конфлюэнс, делится шаблоном. Полезно, на мой взгляд. Лекция про документирование API в Confluence: https://youtu.be/yC89zNQSipE.
Рассказывает Олег Игонин, системный аналитик из Veeam Software.

Вводная от автора:

Хочу рассказать о том, как у меня сложилась работа с описанием API методов в Confluence для постановки задачи на их реализацию разработчикам (структура страниц в confluence, структура заголовков, некоторая автоматизация, описание интерфейса метода и работы логики под капотом).

Будет пара примеров, которые можно будет использовать как "рыбу".
Залью это дело на ютуб, так что кому надо, тот сможет посмотреть задним числом.
Но в целом я не претендую на то, что это "единственно верный метод описания", для вас это будет один из вариантов, как люди работают в других компаниях. Можно будет что-то почерпнуть для себя.

В общем, возьму лампу, кота и буду рассказывать. xD
источник

OA

Olga Alexeeva in technicalwriters
всем привет) может кто знает, можно ли настроить синхронизацию GitHub и Swagger, чтобы при изменении запроса эти изменения автоматически в swagger подтягивались?
источник