Памятка о памятках

Автор: | 17.01.2019

Иногда может понадобиться составить краткую памятку по проекту. Или его мини-описание.

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

А нужно, чтобы “Любой желающий мог быстро прочесть и понять что это за проект, какой там функционал и как юзеры будут его тыркать” (форум).

Можно набросать вот такой документ:

1. Цель проекта

2. Функциональные возможности приложения

<Из каких частей состоит? Для чего они? Что можно сделать? Их зависимости….>

3. Особенности ролей пользователей

<Какие роли могут быть на проекте? Их права, обязанности,…>

4. Варианты использования

<Список основных сценариев использования приложения всеми ролями пользователей>

5. Зависимости проекта с другими системами

<Как будет использоваться? Специфика, интеграции,…>

Но это объёмная вещь. Это не читается быстро, и быстро не понимается. И написано, как всегда, казённым языком священного армейского устава.

Попробуйте кратко объяснить проект любому уличному бомжу.

Начнете в стиле “Мужик, смотри, это нужно для того, чтобы…“. Потом вы осознаете, что нужно контекст объяснять, а не реализацию, и перейдёте на “Чтобы выполнить такую-то задачу, мы используем такую-то шняжку…

Потом в документах будете всегда писать грамотно и сразу всем всё будет понятно.

Бомжу опосля не забудьте проставиться, он ждёт вас.

Памятка о памятках: 3 комментария

  1. Roman Podolyan

    Можно уточке попробовать 🙂
    Один мой знакомый удостоил меня интересного комплимента: “Вот Рома всегда пишет самые подробные инструкции, пошаговые, со скриншотами… Как для дебилов. И они всегда понятны.

  2. Алексей Лупан

    О, шикардос, если есть что скриншотить.
    Но речь о написании не конкретных инструкций, а каких-то общих объяснялок.

  3. Уведомление: Необходимый минимум документации на проекте — Qsusha

Добавить комментарий

Этот сайт использует Akismet для борьбы со спамом. Узнайте, как обрабатываются ваши данные комментариев.