propose new docs structure
Это вторая итерация после !159 (closed), изменения касаются только структуры сайта (расположение подразделов, их названия, имена файлов, структура файлов).
Изменения:
- в "Ознакомление" добавил новый подраздел про обратную связь
- "Глоссарий" переименован в "Основные концепции"
- раздел "Работа с SQL в Picodata" удален из "Ознакомления". Материал частично переехал в broadcasted_sql.md в "Архитектуре".
- вместо отдельного лендинга для подраздела SQL теперь есть просто broadcasted_sql.md в "Архитектуре".
- auth_ldap.md теперь в "Инструкциях"
- новый раздел "Подключение и работа в консоли" в "Инструкциях"
- туториал по Lua и глобальным таблицам убрал. При необходимости, все команды с примерами можно посмотреть в api.md
- удалены лишние/избыточные файлы
- все картинки (*.svg) теперь в отдельной папке images
- заголовки подразделов по возможности сделаны короче
- внутренние ссылки между документами обновлены.
Предлагаю следующую структуру разделов сайта docs:
Ознакомление с ПО Picodata {: #getting-started }
- Общее описание продукта
- Преимущества использования Picodata
- Преимущества языка Rust
- Основные концепции
- Обратная связь и получение помощи
Инструкции и руководства {: #manuals-and-howtos }
- Установка Picodata
- Кластер на физических узлах
- Кластер в контейнерной среде
- Развертывание при помощи Ansible
- Мониторинг кластера
- Подключение и работа в консоли
- Подключение и работа в веб-интерфейсе
- Пользователи и привилегии
- Авторизация с помощью LDAP
- Работа с данными
- Разработка плагинов
- Журнал безопасности
- Устранение неполадок
- Резервное копирование
- Обновление Picodata
Справочные материалы {: #references }
- Аргументы командной строки Picodata
- Справочник настроек Picodata
- Типы данных SQL
- Команды SQL
- Публичный API Picodata
- Совместимость с ANSI SQL
- Перечень событий безопасности
Архитектура {: #arch }
- Распределенный SQL
- Схема данных: таблицы, индексы
- Отказоустойчивость и репликация
- Масштабирование
- Алгоритм Raft
- Алгоритм discovery
- Bootstrap
- Идентификация и аутентификация
- Управление доступом (авторизация)
- Жизненный цикл инстанса
- Жизненный цикл кластера
Part of #79 (closed)