From f876cf14e4c271b14a60ee336a0367984fad77fa Mon Sep 17 00:00:00 2001 From: Repinoid Date: Fri, 2 Oct 2026 09:08:56 +0300 Subject: [PATCH] =?UTF-8?q?docs(history):=20=D0=B8=D1=81=D1=82=D0=BE=D1=87?= =?UTF-8?q?=D0=BD=D0=B8=D0=BA=20=D0=BF=D1=80=D0=B8=D0=BC=D0=B5=D1=80=D0=BE?= =?UTF-8?q?=D0=B2=20=E2=80=94=20tf=5Fexamples/CRUD;=20=D0=BC=D0=BE=D1=8F?= =?UTF-8?q?=20=D0=BE=D1=88=D0=B8=D0=B1=D0=BA=D0=B0=20=D1=81=20=D0=BA=D0=BB?= =?UTF-8?q?=D0=BE=D0=BD=D0=B8=D1=80=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D0=B5?= =?UTF-8?q?=D0=BC=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=208:=20=D1=81=D1=82=D1=80=D0=B0=D0=BD?= =?UTF-8?q?=D0=B8=D1=86=D0=B0=20=D0=BE=D1=82=D0=BF=D1=80=D0=B0=D0=B2=D0=BB?= =?UTF-8?q?=D1=8F=D0=BB=D0=B0=20=D0=BF=D0=BE=D0=BB=D1=8C=D0=B7=D0=BE=D0=B2?= =?UTF-8?q?=D0=B0=D1=82=D0=B5=D0=BB=D1=8F=20=D0=B2=20=D1=80=D0=B5=D0=BF?= =?UTF-8?q?=D0=BE=D0=B7=D0=B8=D1=82=D0=BE=D1=80=D0=B8=D0=B9=20=D0=BF=D1=80?= =?UTF-8?q?=D0=BE=D0=B2=D0=B0=D0=B9=D0=B4=D0=B5=D1=80=D0=B0=20=D0=B8=20?= =?UTF-8?q?=D0=BB=D0=B8=D1=87=D0=BD=D1=8B=D0=B9=20=20=20=D1=81=D1=82=D0=B5?= =?UTF-8?q?=D0=BD=D0=B4=20TEST=5FSTAND/CRUD;=20=D0=BF=D1=80=D0=B0=D0=B2?= =?UTF-8?q?=D0=B8=D0=BB=D1=8C=D0=BD=D1=8B=D0=B9=20=D0=B8=D1=81=D1=82=D0=BE?= =?UTF-8?q?=D1=87=D0=BD=D0=B8=D0=BA=20=E2=80=94=20=D1=80=D0=B5=D0=BF=D0=BE?= =?UTF-8?q?=D0=B7=D0=B8=D1=82=D0=BE=D1=80=D0=B8=D0=B9=20=D0=BF=D1=80=D0=B8?= =?UTF-8?q?=D0=BC=D0=B5=D1=80=D0=BE=D0=B2=20tf=5Fexamples,=20=20=20=D0=BF?= =?UTF-8?q?=D0=B0=D0=BF=D0=BA=D0=B0=20CRUD=20(=D0=BA=D0=B0=D0=BA=20=D0=B2?= =?UTF-8?q?=D0=BE=20=D0=B2=D1=81=D0=B5=D1=85=20=D0=BE=D1=81=D1=82=D0=B0?= =?UTF-8?q?=D0=BB=D1=8C=D0=BD=D1=8B=D1=85=20=D1=81=D1=82=D1=80=D0=B0=D0=BD?= =?UTF-8?q?=D0=B8=D1=86=D0=B0=D1=85:=20vdc=5Fedge=5Fip=5Fsnat.md:3);=20-?= =?UTF-8?q?=20=D1=87=D1=82=D0=BE=20=D1=81=D0=B4=D0=B5=D0=BB=D0=B0=D0=BD?= =?UTF-8?q?=D0=BE:=20tf=5Fexamples/CRUD=20=D0=BF=D0=B5=D1=80=D0=B5=D0=B2?= =?UTF-8?q?=D0=B5=D0=B4=D1=91=D0=BD=20=D0=BD=D0=B0=20=D1=81=D1=85=D0=B5?= =?UTF-8?q?=D0=BC=D1=83=20pg/+apps/=20(=D0=BA=D0=BE=D0=BC=D0=BC=D0=B8?= =?UTF-8?q?=D1=82=20eb65f8b),=20=20=20=D0=B4=D0=BE=D0=BA=D1=83=D0=BC=D0=B5?= =?UTF-8?q?=D0=BD=D1=82=D0=B0=D1=86=D0=B8=D1=8F=20=D1=81=D1=81=D1=8B=D0=BB?= =?UTF-8?q?=D0=B0=D0=B5=D1=82=D1=81=D1=8F=20=D0=BD=D0=B0=20tf=5Fexamples;?= =?UTF-8?q?=20-=20=D1=80=D0=B0=D0=B7=D0=B4=D0=B5=D0=BB=20=D0=BF=D1=80?= =?UTF-8?q?=D0=BE=20=D0=BE=D1=88=D0=B8=D0=B1=D0=BA=D0=B8=20=D1=81=D1=82?= =?UTF-8?q?=D0=B0=D0=BB=209,=20=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB=D0=B5?= =?UTF-8?q?=D0=BD=D0=B0=20=D0=BE=D1=88=D0=B8=D0=B1=D0=BA=D0=B0=20=D0=BF?= =?UTF-8?q?=D1=80=D0=BE=20=D0=B8=D1=81=D1=82=D0=BE=D1=87=D0=BD=D0=B8=D0=BA?= =?UTF-8?q?=20=D0=BF=D1=80=D0=B8=D0=BC=D0=B5=D1=80=D0=BE=D0=B2.=20=D0=9F?= =?UTF-8?q?=D1=80=D0=BE=D0=B2=D0=B5=D1=80=D0=B5=D0=BD=D0=BE:=20=D0=BD?= =?UTF-8?q?=D0=B0=20=D0=B6=D0=B8=D0=B2=D0=BE=D0=B9=20=D1=81=D1=82=D1=80?= =?UTF-8?q?=D0=B0=D0=BD=D0=B8=D1=86=D0=B5=20TEST=5FSTAND=20=E2=80=94=200?= =?UTF-8?q?=20=D0=B2=D1=85=D0=BE=D0=B6=D0=B4=D0=B5=D0=BD=D0=B8=D0=B9,=20tf?= =?UTF-8?q?=5Fexamples=20=E2=80=94=203;=20165935=20=D0=B1=D0=B0=D0=B9?= =?UTF-8?q?=D1=82.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...rud_docs_page_and_manual_pages_pipeline.md | 35 ++++++++++++++++++- 1 file changed, 34 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 8012f2f..b440eb0 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 @@ -211,7 +211,35 @@ README (коммит `272d405`) — на живой странице 167 269 б сначала написал, а требование убрать исполнил не полностью. Проверено: `grep DEV_STAND` по обоим файлам — чисто; на живой странице вхождений — ноль, 165 933 байта. -## 8. Мои ошибки в этой работе +## 8. Источник примеров: `tf_examples`, папка `CRUD` (не репозиторий провайдера) + +> Владелец: «ты ОТКУДА написал клонировать? https://gitea.services.ngcloud.ru/Nail/tf_examples — +> ЗДЕСЬ примеры». + +Моя ошибка: в «Быстром старте» было `git clone …/terraform/tf_provider.git` и +`cd tf_provider/TEST_STAND/CRUD`, а в интро — «Манифесты: `TEST_STAND/CRUD/` в репозитории +провайдера». То есть публичная страница отправляла пользователя в исходник провайдера и в личный +стенд. В остальной документации примеры всегда отдаются из `tf_examples` +(`docs/curated/pipeline/vdc_edge_ip_snat.md:3` — «файлы примера — в репозитории `tf_examples`, +папка `fullpipe_chain`»), — то же надо было сделать и здесь. + +Что сделано: + +- **репозиторий примеров** (`tf_examples`, коммит `eb65f8b`): папка `CRUD` переведена на схему + `pg/` + `apps/` — старые файлы плоской схемы удалены, добавлены `pg/…` и `apps/…` из стенда + `TEST_STAND/CRUD`, провайдер в обоих `main.tf` — `nubes-test/nubes` 3.0.0; + `README.md` — тот же пользовательский текст с клонированием `tf_examples`; + секреты не переносились (копировались только отслеживаемые git файлы стенда: 13 штук, + `terraform.tfvars` и `apps/creds.json` не попадали); +- **документация** (коммит в `tf_provider`): в «Быстром старте» — + `git clone https://gitea.services.ngcloud.ru/Nail/tf_examples.git` и `cd tf_examples/CRUD`; + в интро — «Манифесты: репозиторий примеров `tf_examples`, папка `CRUD`; в README стенда та же + строка и та же команда (документы обязаны совпадать). + +Публикация: страница перезалита — 165 935 байт, `cmp` с локальной сборкой совпал; +`TEST_STAND` на живой странице — 0 вхождений, `tf_examples` — 3. + +## 9. Мои ошибки в этой работе - Разделение `pg/` + `apps/` назвал «разделение ответственности, decoupling» — терминологически неверно (это про модули кода) и заумно. Владелец: «пиши ПРАВИЛЬНО, не надо натягивать заумности». @@ -247,6 +275,11 @@ README (коммит `272d405`) — на живой странице 167 269 б - Написал на страницу про `DEV_STAND/CRUD` по своей инициативе (никто не просил), а когда владелец потребовал убрать — выполнил не полностью (убрав только из README) и отчитался как о выполненном. Это хуже самой лишней строки: отчёт «сделано» без проверки обоих файлов. +- Придумал источником примера репозиторий провайдера (`terraform/tf_provider`, папка + `TEST_STAND/CRUD`) вместо репозитория примеров `tf_examples` — не посмотрел, как это сделано + в соседних опубликованных страницах. Владелец: «ты ОТКУДА написал клонировать?». Вывод: + прежде чем писать в публичную страницу ссылку на репозиторий или папку — сверить с уже + опубликованными страницами и спросить, если источник неочевиден. - Дважды пропустил главное для читателя-новичка: **какие параметры он задаёт своими значениями** и **что имена/домены обязаны быть уникальными**. Пришлось напоминать владельцу. Причина одна: писал про технику (`apply`, выходы, `creds.json`), а не про то, что нужно человеку в начале.