Перейти к основному содержимому

Документация

GigaLoom разрабатывается в krakenalt/gigaloom. Сайт собирается из Markdown в docs/ через Docusaurus wrapper в docs-site/. Общие правила contribution, disclosure и ownership находятся в CONTRIBUTING.md, SECURITY.md и GOVERNANCE.md.

Локальная сборка​

Установите Node.js 20+, затем зависимости Docusaurus:

make docs-install

Соберите все локали:

make docs-build

Для локального preview готового артефакта:

make docs

По умолчанию сайт доступен на http://127.0.0.1:3000/. Команда собирает и обслуживает все настроенные локали, поэтому language switcher работает локально.

Для быстрой разработки одной локали с hot reload:

make docs-dev

Docusaurus dev server обслуживает одну локаль за запуск. Для русской локали:

make docs-dev-ru

Переключение между English и Russian проверяйте через make docs или make docs-preview.

Что публикуется​

Публичный сайт включает:

  • пользовательские руководства из docs/*.md;
  • architecture notes из docs/architecture/;
  • русские переводы из docs-site/i18n/ru/docusaurus-plugin-content-docs/current/;
  • standalone user, operations, security, architecture и release guides;
  • ссылки на target-owned файлы в krakenalt/gigaloom;
  • явно помеченные historical или canonical gateway references.

Игнорируемые docs/internal/** и docs/codex/** — локальное coordination state, а не источник публичного сайта.

Правила обновления​

  • Держите README, docs/index.md, русскую главную страницу и docs-site/sidebars.ts согласованными по основным документам.
  • Для файлов вне docs/ используйте GitHub URL: относительная ссылка на опубликованном Pages-сайте может уйти за границы артефакта.
  • Обновляйте English source и соответствующую русскую страницу в одном change set; сохраняйте code blocks, warnings и ограничения поведения.
  • Не публикуйте секреты, локальные .env, credentials, keys, private code или raw traffic payloads.
  • Текущие development links должны вести в krakenalt/gigaloom.
  • Gateway links держите в gateway-integration.md, а source-repository links в source-history.md с явной маркировкой.
  • При изменении Harness CLI/API/storage обновляйте user guide, architecture, package README и changelog соответствующего дистрибутива.

Проверка перед PR​

python3 scripts/check_docs.py
make docs-build
git diff --check

После сборки просмотрите изменённые страницы в браузере на desktop и узкой ширине, проверьте navigation, search, language switcher, code copy и отсутствие ошибок console.