Один из принципов Agile — «работающее ПО важнее подробной документации» — возможно, стал причиной того, что внутренняя документация современных программных продуктов стала слабым звеном (если она вообще существует). Однако трудно поспорить с тем, что внутренняя документация необходима, особенно в сложных, устаревших системах, которые обслуживают множество клиентов, включают кастомизированные части и в целом сложны в поддержке. Так почему же поддержка документации вызывает такие трудности?
Основная причина — двойная работа. Карточки на Канбан-доске и внутренняя документация существуют в разных жанрах. Карточки представляют собой пользовательские истории, подзадачи, баги и иногда эпики. Внутренняя же документация, как правило, представлена в свободной форме и существует в виде цельных документов, без какой-либо разбивки, удобной для оценки в "стори поинтах". Разработка часто включает в себя изменения в спецификациях в процессе, что делает их сложными для поиска и обновления всей связанной с ними документации.
Проблема в том, что как только документация устаревает, её использование может быть даже опасным, не говоря уже о том, что она становится бесполезной. Как говорят, "\[TOOL\_NAME] — это место, где документация умирает." При отсутствии должной поддержки иногда полезнее просто её удалить.
С помощью Карты продукта вы можете просматривать все функции вашего продукта на одном экране. Кликнув на функцию, вы сможете последовательно просмотреть все итерации этой функции с момента её создания, с указанием программистов, ответственных за каждую итерацию. Этот подход значительно облегчает работу новым членам команды или разработчикам, которые не знакомы с какой-либо функцией — они могут изучить итерации, узнать её историю и понять, к кому обратиться с вопросами. Тикеты Канбана, как правило, существуют отдельно друг от друга, и установить точную взаимосвязь между ними практически невозможно.
Также можно отправить итерацию функции обратно на экран активных итераций из Карты продукта, сняв зелёные индикаторы стадии в списке итераций. Это возвращает итерацию к разработчикам, которые изначально ею занимались.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.ifmethod.com/main-concepts/productbase.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.