Analyst IT – Telegram
Analyst IT
12.4K subscribers
150 photos
100 videos
7 files
1.14K links
Авторский канал для аналитиков в индустрии ИТ. Все, что надо знать аналитику в одном месте.

Сотрудничество: @the_real_bird
BA/SA: @ba_and_sa

Регистрация РКН: https://knd.gov.ru/license?id=673c6a15b7aeb106ce045ee5&registryType=bloggersPermission
Download Telegram
​​О критериях качества требований

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

Перейти к статье | BApedia
3👍3
​​API (Application Programming Interface) – это набор правил и протоколов, позволяющих различным программным системам взаимодействовать друг с другом. В современном мире разработки программного обеспечения API стал неотъемлемой частью системной архитектуры, позволяя разделить функциональность программ на логические блоки и предоставлять возможность использования этих блоков другими системами, как внутренними, так и внешними.

При разработке и эксплуатации API одним из наиболее важных и часто недооцениваемых аспектов является его документирование. Хорошо задокументированное API может стать ключевым фактором успеха проекта, упростив интеграцию с ним и ускорив процесс разработки.

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

Важными аспектами при документировании API являются:

✍🏼1. Описание ресурсов и методов: Документация должна содержать описание всех доступных ресурсов и методов, которые поддерживает API. Каждый ресурс должен быть подробно описан, включая его структуру данных, список полей, доступные методы и возможные запросы/ответы.

📌2. Примеры использования: Хорошая документация должна содержать множество примеров использования API. Примеры помогут разработчикам быстрее разобраться в функциональности и особенностях API, а также позволят им быстрее начать пользоваться им.

🌐3. Схемы данных: Для каждого ресурса API должны быть предоставлены схемы данных, описывающие структуру объектов, передаваемых по API. Схемы данных могут использоваться в процессе валидации запросов и ответов, а также для генерации моделей данных в клиентском коде.

😨4. Ошибки и исключения: Документация должна содержать список возможных ошибок и исключений, которые могут возникнуть при работе с API. Каждая ошибка должна быть подробно описана, включая информацию о причинах ее возникновения и возможные способы ее решения.

🔢5. Версионность: Важным аспектом документации API является указание версии API, чтобы разработчики могли быть уверены, что они используют актуальную версию. Необходимо предоставлять возможность переключения на более новые версии, сохраняя обратную совместимость с предыдущими версиями.

6. Частые обновления: Документация API должна быть актуальной и регулярно обновляться с выпуском новых функций и исправлениями. Это поможет снизить степень путаницы у разработчиков и повысит удовлетворенность пользователей API.

📑7. Интерактивная документация: Для удобства использования API стоит предусмотреть возможность создания интерактивной документации, где разработчики могут отправлять запросы и видеть результаты в реальном времени, а также иметь возможность пробовать различные последовательности запросов.

Правильное документирование API является важным шагом для обеспечения успешной интеграции и сотрудничества с другими системами. Четкая, полная и понятная документация может значительно упростить жизнь разработчикам и сэкономить время и усилия при работе с API.

Материалы по теме:
- Документирование API
- Что такое API документация и как ее правильно составить и использовать?
- How to Write Good API Documentation
👍105🔥5
Forwarded from Testing | QA
«Кто не рискует, тот не поднимает прод в выходные»

@qa_and_it
🤣28😁6🔥3😢1
Forwarded from Product management | IT
This media is not supported in your browser
VIEW IN TELEGRAM
Когда отправил заказчику макет сайта на утверждение, а он предъявляет, что на сайте ничего не работает
😁47🤣18💯5👍1
​​Алоха! Сегодня продолжаем разбирать вопросы, которые любят задавать на собеседовании на роль BA/SA и затронем тему пользовательских историй / user story

#вопросыссобеседования | @ba_and_sa

Часть 14:

📍Вопрос 1: Что такое user story? Какие критерии их написания вы знаете?

Краткий ответ:

User story - это краткое и затрагивающее интересы пользователя описание конкретной функциональности или возможности, отражающее потребности и ожидания конечного пользователя. Оно обычно составляется простым и нетехническим языком и имеет определенный формат, обеспечивающий ясность и эффективность коммуникации между заинтересованными сторонами и командами разработки

Критерии написания user story:

1. Ориентированность на пользователя или ценность: User story должна фокусироваться на потребностях, мотивациях и целях конечных пользователей. Она должна ясно формулировать, чего пользователь хочет достичь и почему это важно для него.

2. Независимость и малая размерность: User story должна быть достаточно маленькой, чтобы быть завершенной в рамках одной итерации разработки, обычно 1-2 недели. Она также должна быть независимой от других историй, чтобы обеспечить гибкость в их приоритезации и планировании.

3. Тестуемость: Каждая user story должна быть написана таким образом, чтобы ее критерии приемки могли быть четко определены и протестированы. Это помогает убедиться в том, что команда разработки и заинтересованные стороны имеют общее понимание успешной реализации.

4. Общая гранулярность: Избегайте слишком детализированных или мелких user story. Лучше фокусироваться на высокоуровневой функциональности, оставляя возможность для команды разработки определить детали при реализации.

5. Оцениваемость: Каждая User Story должна быть оцениваемой. Команда должна иметь возможность оценить сложность и объем работы, необходимых для реализации каждой истории. Это помогает команде планировать и управлять процессом разработки.

📎Материалы по теме:
-
Пользовательские истории в разработке
- Как писать User Stories и зачем они нужны
- Как разработать критерии приёмки для User Story


📍Вопрос 2: Приведите пример user store

Краткий ответ:

Пример хорошо написанной пользовательской истории:

User story строится исходя из шаблона:
«Как» - «Я хочу» - «Чтобы»

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

Критерии приемлемости:
- На странице входа должна быть ссылка «Забыли пароль».
- Щелчок по ссылке «Забыли пароль» должен перенаправить пользователя на страницу сброса пароля.
- Страница сброса пароля должна предлагать пользователю ввести свой зарегистрированный адрес электронной почты.
- После отправки адреса электронной почты система должна отправить электронное письмо со ссылкой для сброса пароля.
- Щелчок по ссылке сброса пароля в электронном письме должен перенаправить пользователя на страницу, где он может ввести новый пароль.
- При успешном сбросе пароля пользователь должен получить подтверждение и быть перенаправленным на страницу входа

📎Материалы по теме:
-
User Story: пора применять правильно
- Пользовательские истории с примерами и шаблоном
Источник: @ba_and_sa

‼️Предыдущие части смотрите по #собеседование #вопросыссобеседования
🔥114👍4
This media is not supported in your browser
VIEW IN TELEGRAM
Та самая задача на испытательном сроке

@analysis_it
🤣56👍9💯6