initial docs

.werf/nginx-local.conf

@@ -100,12 +100,6 @@ http {
        }
 
         location /products/development-platform/documentation/ {
-            proxy_cache dcache;
-            proxy_cache_valid 200 30d;
-            proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;
-            proxy_cache_background_update on;
-            proxy_cache_lock on;
-
             proxy_redirect    off;
             proxy_set_header  Host              $host;
             proxy_set_header  X-Real-IP         $remote_addr;

Makefile

@@ -6,6 +6,7 @@ BIND ?= 0.0.0.0
 SERVE_FLAGS ?= --cleanDestinationDir --bind=$(BIND)
 HUGOFLAGS ?= --minify
 MARKDOWNLINT_VERSION ?= v0.45.0
+WERF_PLATFORM ?= linux/amd64
 
 .PHONY: help serve build clean lint-markdown lint-markdown-fix
 .PHONY: help serve build clean lint-markdown lint-markdown-fix mod
@@ -32,7 +33,7 @@ help:
 
 up:
 	which werf >/dev/null || source $(trdl use werf 2 beta)
-	werf compose up --dev
+	WERF_PLATFORM=$(WERF_PLATFORM) werf compose up --dev
 
 serve:
 	$(HUGO) serve $(SERVE_FLAGS)

content/documentation/_index.md

@@ -1,11 +1,26 @@
 ---
-title: Deckhouse Development Platform Documentation
-description: Documentation for the project, including guides, API references, and tutorials.
+title: Overview
+description: Documentation for the Deckhouse Development Platform product
 weight: 10
 ---
 
-{{< alert level="warning" >}}
-This is the Deckhouse Development Platform alert example.
-{{< /alert >}}
+Deckhouse Development Platform (DDP) is a comprehensive solution for managing all stages of development through a single interface.
 
-Deckhouse Development Platform is a powerful software designed for the efficient delivery of arbitrary applications in Kubernetes.
+The platform helps IT professionals work more efficiently — it automates operations related to the service lifecycle and provides tools to assess the overall system performance.
+
+## Key features
+
+- **Unified development standards for teams**.
+  The platform enables the creation of templates and standard configurations (CI/CD, Kubernetes, etc.) and ensures these standards are propagated across all development teams.
+- **Dynamic environments under control**.
+  Creating, updating, and deleting environments takes just minutes, with stand setup and removal performed automatically.
+- **Integration of otherwise incompatible services**.
+  Interaction can be configured with any infrastructure system that has an API (such as ticket management systems, firewall access management, etc.).
+- **Simplified onboarding of developers and teams**.
+  New team members can start contributing quickly thanks to templates, documentation, and preconfigured project structures provided by the platform.
+- **Digitization of development processes and scenarios**.
+  A BPMN-like process description engine helps automate and optimize all stages of development.
+- **Built-in CMDB**.
+  DDP automatically gathers data from infrastructure services, compiles it into a service catalog, and visualizes the dependencies between them.
+- **Service parameter monitoring**.
+  The solution quickly verifies key service performance indicators using health checks and collects static analysis metrics, vulnerability data, CI/CD pipeline statuses, and more.

content/documentation/_index.ru.md

@@ -1,11 +1,26 @@
 ---
-title: Документация Deckhouse Development Platform
+title: Обзор
+description: Документация продукта Deckhouse Development Platform
 weight: 10
-description: Documentation for the Deckhouse Development Platform project.
 ---
 
-{{< alert level="warning" >}}
-Это пример алерта в документации Deckhouse Development Platform.
-{{< /alert >}}
+Deckhouse Development Platform (DDP) — это комплексное решение для управления всеми этапами разработки через единое окно.
 
-Deckhouse Development Platform — это мощное программное обеспечение, предназначенное для эффективной доставки произвольных приложений в Kubernetes.
+Платформа помогает ИТ-специалистам работать эффективнее — автоматизирует операции, связанные с жизненным циклом сервисов, и предоставляет инструменты для оценки работы всей системы.
+
+## Основные возможности
+
+- **Единые стандарты разработки для команд**.
+  Платформа позволяет подготовить шаблоны и типовые конфигурации (CI/CD, Kubernetes и т. д.) и обеспечивает трансляцию стандартов во все команды разработки.
+- **Динамические окружения под контролем**.
+  Создание, обновление и удаление сред занимает минуты, а подготовка и удаление стендов выполняются автоматически.
+- **Интеграция неинтегрируемых сервисов**.
+  Взаимодействие можно настроить с любой инфраструктурной системой, где есть API (система управления заявками, открытие доступов в firewall и т. д.).
+- **Упрощённый онбординг разработчиков и команд**.
+  Новые сотрудники могут быстро начать работу за счёт шаблонных решений, документации и преднастроенной структуры проектов, которые предоставляет платформа.
+- **Оцифровка процессов и сценариев разработки**.
+  BPMN-подобный механизм описания процессов помогает автоматизировать и оптимизировать все этапы разработки.
+- **Встроенная база данных управления конфигурациями (CMDB)**.
+  DDP автоматически загружает данные из инфраструктурных сервисов, собирает в сервисный каталог и визуализирует зависимости между ними.
+- **Контроль параметров сервисов**.
+  Решение быстро верифицирует ключевые параметры работы сервисов за счёт механизма проверки статуса (health check) и собирает метрики статического анализа, метрики по уязвимостям, статусы выполнения пайплайнов и т. д.

content/documentation/admin/_index.md

@@ -0,0 +1,5 @@
+---
+title: Administration guide
+weight: 60
+---
+

content/documentation/admin/_index.ru.md

@@ -0,0 +1,4 @@
+---
+title: Руководство администратора
+weight: 60
+---

content/documentation/admin/actions/_index.ru.md

@@ -0,0 +1,4 @@
+---
+title: Действия
+weight: 30
+---