Экспорт и модель публикации
Публикация построена вокруг переносимости и предсказуемой доставки результата.
Что входит в экспорт
- структура страниц и навигация
- стили и скрипты взаимодействия
- встроенные изображения и ресурсы документа
- поведение интерфейса чтения, нужное для итогового опыта чтения
Зачем нужен однофайловый формат
Один HTML-файл проще загрузить на статический хостинг, приложить к релизному пакету или передать напрямую без отдельной папки с ресурсами.
Это также сокращает число шагов деплоя, когда опубликованная версия должна жестко соответствовать конкретному релизу или сборке продукта.
Базовые сценарии размещения
- загрузить файл на статический хостинг или в object storage
- опубликовать его на поддомене поддержки или документации
- добавить его в архивы и релизные пакеты продукта
- отправить напрямую, если получателю нужна офлайн-совместимая копия
Организационные замечания
Если вы храните несколько версий, используйте версионированные имена файлов и стабильную публичную индексную страницу.
Когда команде нужен публичный центр документации, размещайте ссылку на актуальный экспорт с заметного маршрута вроде этого онлайн-раздела справки.