docs: unify APG overview, update checksums

Author: AnmiTaliDev

docs/apg/standart/apgv2/obzor.md

@@ -1,34 +1,28 @@
 # Обзор стандарта APG
 
-## Общие сведения
+## Что такое APG?
 
-### Что такое APG?
+**APG (APG Package)** — собственный формат пакетов для операционной системы NurOS, разработанный для обеспечения быстрой установки, полной поддержки зависимостей и простоты создания пакетов.
 
-**APG (Advanced Package)** — рекурсивный акроним, расшифровывающийся как "APG Package". Это собственный формат пакетов для операционной системы NurOS, разработанный для обеспечения быстрой установки, полной поддержки зависимостей и простоты создания пакетов.
+APG был создан командой NurOS как альтернатива существующим форматам пакетов с целью обеспечить:
 
-### История создания
+- Простоту в понимании и использовании
+- Полный контроль над процессом установки
+- Поддержку современных возможностей управления пакетами
+- Легкую расширяемость для будущих нужд
 
-APG был разработан командой NurOS как альтернатива существующим форматам пакетов. Целью было создание формата, который:
-
-* Прост в понимании и использовании
-* Обеспечивает полный контроль над процессом установки
-* Поддерживает современные возможности управления пакетами
-* Легко расширяется для будущих нужд
-
-### Текущая версия
-
-**APGv2** — текущая версия формата, используемая в NurOS.
+**Текущая версия**: APGv2
 
 ## Основные принципы
 
 ### Простота
 
 APG использует стандартные форматы и инструменты:
 
-* **Архив**: tar с сжатием (xz, zst)
-* **Метаданные**: JSON формат
-* **Скрипты**: обычные shell-скрипты
-* **Контрольные суммы**: MD5
+- **Архив**: tar с сжатием (xz, zst)
+- **Метаданные**: JSON формат
+- **Скрипты**: обычные shell-скрипты
+- **Контрольные суммы**: CRC32 или MD5 (на выбор)
 
 ### Прозрачность
 
@@ -44,177 +38,63 @@ tar -xf package.apg
 
 ### Расширяемость
 
-Формат позволяет:
-
-* Добавлять новые поля в метаданные без нарушения совместимости
-* Использовать пользовательские скрипты установки
-* Поддерживать множественные архитектуры
-
-## Компоненты экосистемы APG
-
-### Формат пакетов
+Формат позволяет добавлять новые поля в метаданные без нарушения совместимости, использовать пользовательские скрипты установки и поддерживать множественные архитектуры.
 
-Базовая спецификация формата `.apg` файлов.
+## Компоненты экосистемы
 
-### Инструменты
-
-| Инструмент | Назначение |
-|------------|------------|
+| Компонент | Описание |
+|-----------|----------|
+| **Формат пакетов** | Базовая спецификация формата `.apg` файлов |
 | **Tulpar** | Пакетный менеджер для установки и управления пакетами |
 | **apgbuild** | Утилита для создания пакетов |
 | **Tulpar Server** | Сервер для распространения пакетов |
 | **libapg** | Библиотека для работы с APG пакетами |
 
-### Экосистема
-
-```
-┌─────────────────────────────────────────┐
-│         Пользователь NurOS              │
-└──────────────┬──────────────────────────┘
-               │
-       ┌───────▼────────┐
-       │     Tulpar     │ ← Пакетный менеджер
-       │   (клиент)     │
-       └───────┬────────┘
-               │
-   ┌───────────┼────────────┐
-   │           │            │
-┌──▼──┐   ┌───▼────┐   ┌───▼────────┐
-│ APG │   │ Tulpar │   │   libapg   │
-│файл │   │ Server │   │(библиотека)│
-└─────┘   └────────┘   └────────────┘
-   ▲
-   │
-┌──┴────────┐
-│ apgbuild  │ ← Создание пакетов
-│(сборщик)  │
-└───────────┘
-```
-
-## Преимущества формата
-
-### Для пользователей
-
-1. **Быстрая установка**
-   * Оптимизированная распаковка архивов
-   * Минимальные проверки перед установкой
-
-2. **Надежность**
-   * Проверка контрольных сумм
-   * Управление зависимостями
-   * Откат при ошибках
-
-3. **Прозрачность**
-   * Видимость всех файлов пакета
-   * Понятные метаданные
-   * Логирование установки
-
-### Для разработчиков
-
-1. **Простота создания**
-   * Автоматизация через apgbuild
-   * Простая структура директорий
-   * Минимум требований
-
-2. **Гибкость**
-   * Пользовательские скрипты
-   * Поддержка любых архитектур
-   * Расширяемые метаданные
+## Типы пакетов
 
-3. **Совместимость**
-   * Работа на любой Linux-системе
-   * Стандартные инструменты
-   * Открытый формат
+| Тип | Описание | Примеры |
+|-----|----------|---------|
+| `binary` | Скомпилированные бинарные файлы, готовые к использованию | Программы, библиотеки, драйверы |
+| `source` | Исходный код для компиляции на целевой системе | Исходники программ, патчи |
+| `misc` | Прочие файлы, не являющиеся программами | Темы оформления, шрифты, документация, данные |
 
 ## Поддерживаемые архитектуры
 
-APG поддерживает следующие архитектуры процессоров:
-
 | Архитектура | Описание | Статус |
 |-------------|----------|--------|
 | `x86_64` | 64-битные процессоры AMD/Intel | ✅ Полная поддержка |
 | `aarch64` | 64-битные процессоры ARM | ✅ Полная поддержка |
 | `riscv64` | 64-битные процессоры RISC-V | ✅ Полная поддержка |
 | `all` | Архитектурно-независимые пакеты | ✅ Полная поддержка |
 
-## Типы пакетов
-
-### binary
-
-Скомпилированные бинарные файлы, готовые к использованию.
-
-**Примеры**: программы, библиотеки, драйверы
-
-### source
-
-Исходный код для компиляции на целевой системе.
-
-**Примеры**: исходники программ, патчи
-
-### misc
-
-Прочие файлы, не являющиеся программами.
-
-**Примеры**: темы оформления, шрифты, документация, данные
-
-## Сравнение с другими форматами
-
-### APG vs DEB (Debian)
-
-| Характеристика | APG | DEB |
-|----------------|-----|-----|
-| Формат архива | tar.xz/tar.zst | ar + tar.gz |
-| Метаданные | JSON | Control файлы |
-| Сложность | Простой | Средняя |
-| Скрипты | Bash | Bash (debconf) |
-| Зависимости | Простые | Сложные (alternatives) |
-
-### APG vs RPM (Red Hat)
+## Преимущества формата
 
-| Характеристика | APG | RPM |
-|----------------|-----|-----|
-| Формат | tar.xz/tar.zst | cpio + rpm |
-| Метаданные | JSON | Spec файлы |
-| Сложность | Простой | Высокая |
-| База данных | JSON файлы | Berkeley DB |
-| Подпись | Планируется | GPG |
+### Для пользователей
 
-### APG vs PKG (Arch)
+Быстрая установка благодаря оптимизированной распаковке архивов и минимальным проверкам. Надежность обеспечивается проверкой контрольных сумм, управлением зависимостями и откатом при ошибках. Прозрачность достигается за счет видимости всех файлов пакета, понятных метаданных и логирования установки.
 
-| Характеристика | APG | PKG |
-|----------------|-----|-----|
-| Формат | tar.xz/tar.zst | tar.xz/tar.zst |
-| Метаданные | JSON | .PKGINFO |
-| Сложность | Простой | Простой |
-| Сборка | apgbuild | makepkg |
-| Философия | Похожие подходы | Похожие подходы |
+### Для разработчиков
 
-## Лицензия и открытость
+Простота создания пакетов обеспечивается автоматизацией через apgbuild, простой структурой директорий и минимумом требований. Гибкость проявляется в возможности использовать пользовательские скрипты, поддерживать любые архитектуры и расширять метаданные. Совместимость достигается работой на любой Linux-системе, использованием стандартных инструментов и открытым форматом.
 
-### Лицензирование
+## Лицензирование
 
 Формат APG и все связанные инструменты распространяются под свободными лицензиями:
 
-* **Спецификация формата**: Public Domain / CC0
-* **Tulpar**: GNU GPL 3.0
-* **apgbuild**: GNU GPL 3.0
-* **Tulpar Server**: GNU GPL 3.0
-
-### Открытый стандарт
+| Компонент | Лицензия |
+|-----------|----------|
+| Спецификация формата | Public Domain / CC0 |
+| Tulpar | GNU GPL 3.0 |
+| apgbuild | GNU GPL 3.0 |
+| Tulpar Server | GNU GPL 3.0 |
 
-APG является открытым стандартом:
-
-* Полная спецификация доступна публично
-* Возможность создания альтернативных реализаций
-* Приветствуется обратная связь и предложения
+APG является открытым стандартом с публично доступной спецификацией, возможностью создания альтернативных реализаций и приветствием обратной связи.
 
 ## Примеры пакетов
 
 ### Официальный пример APGv2
 
-Полный рабочий пример пакета в формате APGv2:
-
-📦 **Репозиторий**: https://github.com/NurOS-Linux/APGexample
+Полный рабочий пример пакета в формате APGv2 доступен в репозитории: https://github.com/NurOS-Linux/APGexample
 
 ```bash
 # Клонировать пример
@@ -232,26 +112,18 @@ apgbuild build .
 
 ### Пример APGv1 (Legacy)
 
-Для сравнения доступен пример в устаревшем формате APGv1:
-
-📦 **Ветка APGv1**: https://github.com/NurOS-Linux/APGexample/tree/APGv1
+Для сравнения доступен пример в устаревшем формате APGv1 в ветке APGv1: https://github.com/NurOS-Linux/APGexample/tree/APGv1
 
 ```bash
 # Клонировать APGv1 пример
 git clone -b APGv1 https://github.com/NurOS-Linux/APGexample
 cd APGexample
 ```
 
-## Дальнейшее чтение
-
-* [Структура пакета APG](./struktura-paketa.md)
-* [Файл metadata.json](./fail-metadata.json.md)
-
-## Ссылки
+:::info Информация
+APG разработан с учетом опыта существующих форматов пакетов и предлагает баланс между простотой и функциональностью.
+:::
 
-* **Репозиторий спецификации**: https://github.com/NurOS-Linux/apg-docs
-* **Tulpar**: https://github.com/NurOS-Linux/Tulpar
-* **apgbuild**: https://github.com/NurOS-Linux/apgbuild
-* **Tulpar Server**: https://github.com/NurOS-Linux/tulpar-server
-* **Пример пакета APGv2**: https://github.com/NurOS-Linux/APGexample
-* **Пример пакета APGv1**: https://github.com/NurOS-Linux/APGexample/tree/APGv1
+:::warning Внимание
+APGv1 является устаревшим форматом. Для новых пакетов используйте APGv2.
+:::