mirror of
https://github.com/Ku6epXBOCTuK/easy-png-tools.git
synced 2026-11-13 17:08:20 +00:00
54 lines
3.1 KiB
Markdown
54 lines
3.1 KiB
Markdown
# Архив документов
|
|
|
|
> Статус: **active**. Здесь хранятся завершённые, отменённые и явно устаревшие
|
|
> документы как временная историческая справка.
|
|
|
|
## Назначение
|
|
|
|
Архив помогает быстро посмотреть, какое решение принималось раньше и почему. Он
|
|
не является источником текущих требований, критериев приёмки или команды. Для
|
|
актуальных правил используются `AGENTS.md`, `docs/README.md` и активные планы.
|
|
|
|
Если решение снова понадобится, его можно восстановить из git history или
|
|
создать новый активный документ: **архивные файлы удаляются, а не хранятся
|
|
вечно.** Удалённые планы восстановимы через
|
|
`git log --diff-filter=D -- name-only -- docs/archive/` и
|
|
`git show <commit>^:<path>`.
|
|
|
|
## Обязательные метаданные
|
|
|
|
При переносе документа в архив добавить в начало:
|
|
|
|
```text
|
|
> Статус: archived
|
|
> Архивирован: YYYY-MM-DD
|
|
> Удалить после: YYYY-MM-DD
|
|
> Причина: краткое объяснение, почему документ больше не активен
|
|
> Использование: только историческая справка
|
|
```
|
|
|
|
Дата `Удалить после` — дата архивирования плюс 30 дней.
|
|
|
|
## Порядок архивирования
|
|
|
|
1. Убедиться, что документ действительно завершён, отменён или заменён более
|
|
актуальным источником.
|
|
2. Убрать из него ссылки на несуществующие пути и артефакты прошлых волн.
|
|
3. Добавить обязательные метаданные.
|
|
4. Переместить файл в `docs/archive/`.
|
|
5. Проверить ссылки из backlog, планов, checklist и `docs/README.md`: удалённые
|
|
файлы должны потерять и входящие ссылки.
|
|
6. Не менять архивный документ под новые требования.
|
|
|
|
## Удаление
|
|
|
|
Через 30 дней после архивирования:
|
|
|
|
- проверить, что документ не нужен для текущей работы;
|
|
- найти и удалить оставшиеся ссылки на него из активных документов;
|
|
- удалить файл из `docs/archive/`.
|
|
|
|
До истечения срока архивный файл не превращается обратно в live-документ: если
|
|
он снова актуален, создаётся новый документ или возвращается версия из git
|
|
истории с новым статусом и датами.
|