From 215e57baa8c99470fa621488b01c594b403e2e1d Mon Sep 17 00:00:00 2001 From: Repinoid Date: Fri, 2 Oct 2026 08:46:58 +0300 Subject: [PATCH] =?UTF-8?q?docs(history):=20=D0=BF=D0=BE=D1=80=D1=8F=D0=B4?= =?UTF-8?q?=D0=BE=D0=BA=20=D1=80=D0=B0=D0=B7=D0=B4=D0=B5=D0=BB=D0=BE=D0=B2?= =?UTF-8?q?,=20=D1=87=D0=B8=D1=81=D1=82=D0=BA=D0=B0=20=D0=BD=D0=B5=D0=B4?= =?UTF-8?q?=D0=BE=D1=81=D1=82=D1=83=D0=BF=D0=BD=D0=BE=D0=B3=D0=BE=20=D0=BF?= =?UTF-8?q?=D0=BE=D0=BB=D1=8C=D0=B7=D0=BE=D0=B2=D0=B0=D1=82=D0=B5=D0=BB?= =?UTF-8?q?=D1=8E,=20=D0=BC=D0=BE=D0=B8=20=D0=BE=D1=88=D0=B8=D0=B1=D0=BA?= =?UTF-8?q?=D0=B8=20-=20=D0=BD=D0=BE=D0=B2=D1=8B=D0=B9=20=D1=80=D0=B0?= =?UTF-8?q?=D0=B7=D0=B4=D0=B5=D0=BB=206:=20=C2=AB=D0=91=D1=8B=D1=81=D1=82?= =?UTF-8?q?=D1=80=D1=8B=D0=B9=20=D1=81=D1=82=D0=B0=D1=80=D1=82=C2=BB=20?= =?UTF-8?q?=D0=BF=D0=B5=D1=80=D0=B2=D1=8B=D0=BC,=20=D0=BE=D0=BF=D0=B8?= =?UTF-8?q?=D1=81=D0=B0=D0=BD=D0=B8=D0=B5=20=D0=BD=D0=B8=D0=B6=D0=B5;=20?= =?UTF-8?q?=D1=83=D0=B1=D1=80=D0=B0=D0=BD=D1=8B=20=D1=80=D0=B0=D0=B7=D0=B4?= =?UTF-8?q?=D0=B5=D0=BB=20=D0=BF=D1=80=D0=BE=20=20=20instanceOperations=20?= =?UTF-8?q?=D0=B8=20=D1=81=D1=81=D1=8B=D0=BB=D0=BA=D0=B0=20=D0=BD=D0=B0=20?= =?UTF-8?q?HISTORY/=E2=80=A6;=20=D1=83=D0=B1=D1=80=D0=B0=D0=BD=D1=8B=20?= =?UTF-8?q?=D1=81=D1=81=D1=8B=D0=BB=D0=BA=D0=B8=20=D0=BD=D0=B0=20=D0=B2?= =?UTF-8?q?=D0=BD=D1=83=D1=82=D1=80=D0=B5=D0=BD=D0=BD=D0=B8=D0=B9=20=D0=BA?= =?UTF-8?q?=D0=BE=D0=B4=20=20=20(crud.go:171,=20refsvc=5Ffind.go:47),=20?= =?UTF-8?q?=D0=BD=D0=B0=20=D1=81=D1=82=D1=80=D0=BE=D0=BA=D0=B8=20apps/loca?= =?UTF-8?q?ls.tf:45,57,68=20=D0=B8=20=D0=B0=D0=B1=D0=B7=D0=B0=D1=86=20?= =?UTF-8?q?=D0=BF=D1=80=D0=BE=20=20=20=D0=BF=D1=80=D0=B5=D0=B6=D0=BD=D0=B8?= =?UTF-8?q?=D0=B5=20=D0=B8=D0=BC=D0=B5=D0=BD=D0=B0;=20=D1=81=D0=BE=20?= =?UTF-8?q?=D1=81=D1=82=D1=80=D0=B0=D0=BD=D0=B8=D1=86=D1=8B=20=D1=83=D0=B1?= =?UTF-8?q?=D1=80=D0=B0=D0=BD=D0=BE=20=C2=AB=D1=81=D0=BC=D0=BE=D1=82=D1=80?= =?UTF-8?q?=D0=B8=D1=82=D0=B5=20=D0=B6=D1=83=D1=80=D0=BD=D0=B0=D0=BB=20?= =?UTF-8?q?=D0=BE=D0=BF=D0=B5=D1=80=D0=B0=D1=86=D0=B8=D0=B8=C2=BB;=20-=20?= =?UTF-8?q?=D1=80=D0=B0=D0=B7=D0=B4=D0=B5=D0=BB=20=D0=BF=D1=80=D0=BE=20?= =?UTF-8?q?=D0=BE=D1=88=D0=B8=D0=B1=D0=BA=D0=B8=20=D1=81=D1=82=D0=B0=D0=BB?= =?UTF-8?q?=207;=20=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB=D0=B5=D0=BD=D1=8B?= =?UTF-8?q?=20=D1=82=D1=80=D0=B8=20=D0=BE=D1=88=D0=B8=D0=B1=D0=BA=D0=B8:?= =?UTF-8?q?=20=D0=BD=D0=B5=D1=80=D0=B0=D0=B1=D0=BE=D1=87=D0=B8=D0=B9=20?= =?UTF-8?q?=D0=B1=D0=BB=D0=BE=D0=BA=20=D0=B4=D0=B8=D0=B0=D0=B3=D0=BD=D0=BE?= =?UTF-8?q?=D1=81=D1=82=D0=B8=D0=BA=D0=B8=20=20=20=D0=BF=D0=B5=D1=80=D0=B5?= =?UTF-8?q?=D0=BD=D1=91=D1=81=20=D0=B4=D0=B0=D0=BB=D1=8C=D1=88=D0=B5,=20?= =?UTF-8?q?=D0=BD=D0=B5=20=D0=BF=D1=80=D0=BE=D0=B2=D0=B5=D1=80=D0=B8=D0=B2?= =?UTF-8?q?=20=D0=BF=D1=80=D0=B8=D0=B3=D0=BE=D0=B4=D0=BD=D0=BE=D1=81=D1=82?= =?UTF-8?q?=D1=8C=20=D0=B4=D0=BB=D1=8F=20=D1=87=D0=B8=D1=82=D0=B0=D1=82?= =?UTF-8?q?=D0=B5=D0=BB=D1=8F;=20=D0=BC=D0=BD=D0=BE=D0=B3=D0=BE=20=D1=82?= =?UTF-8?q?=D0=B5=D0=BA=D1=81=D1=82=D0=B0=20=D0=B2=D0=BF=D0=B5=D1=80=D1=91?= =?UTF-8?q?=D0=B4=20=D0=B1=D0=B5=D0=B7=20=20=20=D1=81=D0=BE=D0=B3=D0=BB?= =?UTF-8?q?=D0=B0=D1=81=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D1=8F=20=D0=BF=D0=BE?= =?UTF-8?q?=D1=80=D1=8F=D0=B4=D0=BA=D0=B0.=20=D0=9F=D1=80=D0=BE=D0=B2?= =?UTF-8?q?=D0=B5=D1=80=D0=B5=D0=BD=D0=BE:=20=D1=80=D0=B0=D0=B7=D0=B4?= =?UTF-8?q?=D0=B5=D0=BB=D1=8B=201-7=20=D0=BD=D0=B0=20=D0=BC=D0=B5=D1=81?= =?UTF-8?q?=D1=82=D0=B5,=20=D1=84=D0=B0=D0=BA=D1=82=D1=8B=20(162257=20?= =?UTF-8?q?=D0=B1=D0=B0=D0=B9=D1=82,=20=D0=BD=D1=83=D0=BB=D0=B5=D0=B2?= =?UTF-8?q?=D1=8B=D0=B5=20=D0=B2=D1=85=D0=BE=D0=B6=D0=B4=D0=B5=D0=BD=D0=B8?= =?UTF-8?q?=D1=8F)=20=E2=80=94=20=D0=B8=D0=B7=20=D0=BF=D1=80=D0=BE=D0=B2?= =?UTF-8?q?=D0=B5=D1=80=D0=BA=D0=B8=20=D0=B6=D0=B8=D0=B2=D0=BE=D0=B9=20?= =?UTF-8?q?=D1=81=D1=82=D1=80=D0=B0=D0=BD=D0=B8=D1=86=D1=8B.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...rud_docs_page_and_manual_pages_pipeline.md | 30 ++++++++++++++++++- 1 file changed, 29 insertions(+), 1 deletion(-) diff --git a/HISTORY/50_docs/2026-10-02_crud_docs_page_and_manual_pages_pipeline.md b/HISTORY/50_docs/2026-10-02_crud_docs_page_and_manual_pages_pipeline.md index d12e099..67d7d38 100644 --- a/HISTORY/50_docs/2026-10-02_crud_docs_page_and_manual_pages_pipeline.md +++ b/HISTORY/50_docs/2026-10-02_crud_docs_page_and_manual_pages_pipeline.md @@ -138,7 +138,30 @@ README (коммит `272d405`) — на живой странице 167 269 б Дополнительно: `ssh naeel@5.172.178.213` без алиаса даёт `Permission denied (publickey)` — рабочий доступ только через алиас `vps` (`~/.ssh/config` → ключ `~/.ssh/naeel_vm_id_ed25519`). -## 6. Мои ошибки в этой работе +## 6. Порядок разделов и чистка «для юзера» (коммит `bfa9d5f`) + +> Владелец: «ЮЗЕРУ НАХУЙ не интересно ВСЁ это читать! СНАЧАЛА — кратко чё это вообще и ДЕЙСТВИЯ … +> всё остальное описание — ПОСЛЕ» → «юзер НЕ МОЖЕТ вводить никакие команды … УБЕРИ ЭТО и подобное». + +Что изменено в `TEST_STAND/CRUD/README.md` и `docs/curated/crud/three_apps.md`: + +- раздел **«Быстрый старт» — первым**: клонирование, заполнение переменных, `apply` в `pg/`, + выгрузка `creds.json`, `apply` в `apps/`, адреса приложений, предупреждение про пароль в файле; + весь остальной текст — ниже (в README: «Как это устроено», «Что пользователь задаёт сам», + «Код приложений (git)», «Повседневные операции», «Файлы», «Справка»); +- убраны из README «Если `apply` упал» и со страницы «Диагностика, если `apply` упал»: содержали + `GET {api_endpoint}/instanceOperations/?...` — вызовы, которые пользователь сделать не может + (нет ни `curl`, ни авторизации), и ссылку на `HISTORY/60_stands/…` — файл внутреннего репозитория; +- убраны ссылки на внутренний код (`provider/internal/resources_core/crud.go:171`, + `provider/internal/core/refsvc_find.go:47`) и на строки примера (`apps/locals.tf:45,57,68`); + убран абзац про прежние имена `tflucee`/`tfflask`/`tfnodejs` — внутренняя история; +- со страницы убрано «смотрите журнал операции, а не только текст ошибки» (в «Особенности»). + +Проверка (живая страница, `nubes-test/curated/crud/three_apps/`): 162 257 байт, `cmp` с локальной +сборкой — совпала; вхождений `instanceOperations`, `errorLog`, `HISTORY/`, `crud.go`, `refsvc_find` +— **ноль**; первый раздел — «Быстрый старт». + +## 7. Мои ошибки в этой работе - Разделение `pg/` + `apps/` назвал «разделение ответственности, decoupling» — терминологически неверно (это про модули кода) и заумно. Владелец: «пиши ПРАВИЛЬНО, не надо натягивать заумности». @@ -158,6 +181,11 @@ README (коммит `272d405`) — на живой странице 167 269 б - В README изначально не было **входа в пример** (как получить файлы — клонирование) и **выхода** (куда зайти после `apply`). Владелец: «где про клонирование???». Ошибка того же рода, что ниже: документировал устройство, а не путь пользователя от нуля до результата. +- Перенёс в README и на страницу нерабочий блок диагностики (`GET {api_endpoint}/…`) и ссылку на + `HISTORY/…`, не проверив, может ли читатель этим воспользоваться. Блок был не мой (коммит + `00bfe7a`), но перетащил его дальше именно я — секция не моя, а ошибка моя. +- Внёс в README сразу много текста вперёд (клонирование + адреса + диагностика), не спросив + порядок — владелец потребовал переставить всё так, чтобы сначала были действия. - Дважды пропустил главное для читателя-новичка: **какие параметры он задаёт своими значениями** и **что имена/домены обязаны быть уникальными**. Пришлось напоминать владельцу. Причина одна: писал про технику (`apply`, выходы, `creds.json`), а не про то, что нужно человеку в начале.