From bc68bfd4c7512a67bd02d0c4eda4b7a37a8c05e1 Mon Sep 17 00:00:00 2001 From: Mikhail Yenuchenko Date: Thu, 6 Aug 2026 15:36:51 +0300 Subject: [PATCH] docs: schedule implementation-plan.md retirement in roadmap MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The document is closed: no unique content remains — § D (pre-release security review) is duplicated in progress.md, security.md and the CHANGELOG, and B.1-B.3/C.4 were trimmed in 22f86d1. It stays until the tag only because it describes the release gate. Record the retirement as a v1.x tail item in roadmap.md with the concrete steps: archive the file and retarget its references, including the stale "plan C.4" pointers in Makefile, release.yml and the e2e test. Co-Authored-By: Claude Opus 5 --- CHANGELOG.md | 3 +++ docs/roadmap.md | 26 +++++++++++++++++++++++++- 2 files changed, 28 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 4dfae4c..37c24ab 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -17,6 +17,9 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); version ### Added +- docs: `docs/roadmap.md` v1.x tail — retire `implementation-plan.md` in the + release commit (move to `docs/archive/`, retarget its references in README, + docs, Makefile, release workflow and the e2e test comment). - docs: `docs/code-review.md` — phase 1.5 plan for optional password encryption of full backup (`.spbk`) and domain export (`.spde`); checkbox UI pattern; remove session-resurrection-from-backup as accepted risk. diff --git a/docs/roadmap.md b/docs/roadmap.md index b41f440..2a217f9 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -34,8 +34,32 @@ Codeberg (`codeberg.org/mix/selfpost/raw/branch/main/deploy/...`). **Каталог `docs/logo`.** Пустой; либо наполнить (если нужен отдельный asset для внешних ссылок), либо удалить каталог, чтобы не создавать ложное ожидание. +**Убрать `implementation-plan.md` — в релизном коммите.** Документ закрыт: +уникального содержания в нём нет, § D (предрелизная ревизия безопасности) +продублирован в [progress.md](progress.md), [security.md](security.md) и +CHANGELOG `[Unreleased]/Security`, а разделы B.1–B.3 и C.4 вырезаны ещё в +`22f86d1`. Держится до тега только потому, что описывает релизный гейт, пока тот +формально не закрыт. При резке версии: + +1. Переместить в `docs/archive/` (рядом со `specification-v1.0.md`) — история + § D сохраняется, из активной документации уходит. +2. Перецелить ссылки из кода и CI ([Makefile](../Makefile), + [.github/workflows/release.yml](../.github/workflows/release.yml), + [test/e2e/main_test.go](../test/e2e/main_test.go)) — они ссылаются на «план + C.4», секцию, которой в файле уже нет; актуальное описание e2e — в + [development.md](development.md). +3. Перецелить ссылки из документации: [README.md](../README.md) («Open v1.x + questions» — открытых вопросов там нет) → [progress.md](progress.md); + [code-review.md](code-review.md), [security.md](security.md), + [documentation-plan.md](documentation-plan.md), [progress.md](progress.md) и + шапку этого файла → на `progress.md`/`security.md`. +4. В [progress.md](progress.md) убрать шаг «Открыть `implementation-plan.md`» — + он выполнен. + **Готово, когда:** Quick start указывает на Codeberg; тег образа в compose -совпадает с релизом; `docs/logo` либо содержит файлы, либо отсутствует. +совпадает с релизом; `docs/logo` либо содержит файлы, либо отсутствует; +`implementation-plan.md` в `docs/archive/`, ссылок на него в активных документах +и в коде/CI не осталось. **Send-log vs `mail.log` (опционально).** После рестарта панели или пересоздания контейнера строки send-log могут навсегда остаться `queued` — log-tailer не