Помощь
Помощь без зависимости
Foundation рассчитан на самостоятельную помощь, и модель помощи это отражает. У Foundation нет службы поддержки, нет аккаунта для создания и нет формы обратной связи на этом сайте: придумать её значило бы подразумевать сервис, которого нет. Ниже то, что действительно доступно.
- Документация поставляется вместе с кодом в публичном репозитории, поэтому не может отойти от того, что описывает.
- Три законных пути: сделать самому, использовать своего разработчика или агентство либо необязательную помощь Provelopment, без рекомендованного победителя.
- Ничто из описанного здесь не закрыто, и эта страница не обещает времени ответа.
Три законных способа получить помощь
Это пути, которые люди действительно выбирают, и все они одинаково допустимы. Ни один не привилегирован: сайт, к которому вы придёте, один и тот же.
Помочь себе самому
Публичный репозиторий — основной канал помощи для Foundation. Его документация написана так, чтобы по ней следовали, а не просматривали её, и версионируется вместе с описываемым кодом.
- README, руководство по настройке, документ об архитектуре, runbook развёртывания и руководства владеют каждый своей темой.
- Шлюз валидации сообщает о проблемах конфигурации при сборке, называя настройку, что решает большинство проблем сразу.
- Ничего не удерживается: нет платного уровня, который открывал бы документацию, код или работающую установку.
Использовать своего разработчика или агентство
Поскольку всё, что должен менять внедренец, находится в конфигурации, контенте и ресурсах, а не в коде платформы, сайт Foundation может принять любой компетентный веб-разработчик, даже не видевший Foundation.
- Передача не зависит от скрытых знаний: граница владения и архитектура документированы, а тесты обеспечивают описанные границы.
- Есть самый короткий путь от нуля до продуктивной работы, и он длиной в два документа.
- Ничто в эксплуатации, изменении или развёртывании сайта Foundation не требует участия Provelopment.
Спросить Provelopment
Provelopment может предоставить внедрение, техническую помощь, поддержку и управляемые сервисы организациям, которым это нужно. Это отдельно от основы и полностью необязательно.
- Foundation этого не требует, и ничто в программном обеспечении от этого не зависит.
- Это согласуется отдельно: этот сайт не является каналом поддержки или продаж.
- Внедрить Foundation, развернуть его самостоятельно и ни разу не обратиться в Provelopment — полностью успешный результат.
Ни один не является рекомендуемым. Привлекать помощь или обойтись без неё — решение о сервисе, которое можно принять или отменить в любой момент, не меняя программное обеспечение.
Документы, владеющие ответами
Технические вопросы решаются в репозитории, рядом с кодом, который описывает ответ. Каждый документ ниже авторитетен в своей теме, и поэтому эта страница его не повторяет.
README
Что это за проект, как начать, структура репозитория и реальные команды проверки.
CUSTOMIZING.md
Руководство для последующего пользователя и полный справочник конфигурации, включая таблицу, где разделено ваше и платформенное.
ARCHITECTURE.md
Архитектурный стиль, границы, направление зависимостей и шаблоны интеграции.
DEPLOYMENT.md
Runbook выпуска: первое развёртывание, защита непрерывной интеграции, собственный домен и проверки после развёртывания.
BRAND_ASSETS.md
Контракт замены брендовых ресурсов: каждая заменяемая визуальная роль в порядке замены.
instruction-manuals/
Процедуры: внедрение, настройка, бренд, контент, валидация, развёртывание, обновление и устранение неполадок.
troubleshooting.md
Повторяющиеся сбои и их безопасные решения, включая те, что появляются после обновления.
Если этот сайт и репозиторий разойдутся, прав репозиторий. Эта страница показывает, куда смотреть; работу делает репозиторий.
Какой источник отвечает на какой вопрос
Большинство посетителей приходят с одним из нескольких вопросов. Ниже адреса, которые на них отвечают, и ни один не требует аккаунта или разговора.
Что такое Foundation и что он даёт?
Собственное объяснение проекта о его охвате, границах и поведении частей.
Как он устроен технически?
Слои, направление зависимостей и границы, которые обеспечивают тесты.
Как адаптировать сайт под мой бизнес?
Идентичность, бренд, контент, словари и ресурсы, а также файлы, которые вы будете менять.
Как его опубликовать?
Runbook развёртывания: первое развёртывание, собственный домен и проверки после него.
Как выглядит завершённый сайт Foundation?
Две работающие демонстрации на одной основе, с разным контентом, идентичностью и навигацией.
Что-то не так на моём сайте.
Процедура устранения неполадок содержит действительно повторявшиеся проблемы, каждая с безопасным проверенным решением; процедура валидации определяет, что значит пройденная проверка.
Я предпочёл бы, чтобы внедрением или поддержкой занимался кто-то другой.
Собственный сайт Provelopment описывает, что он предоставляет. Такое соглашение заключается отдельно от проекта.
Эта страница намеренно не воспроизводит руководства. Она указывает на них, чтобы у каждого ответа был ровно один авторитет.
Если вы застряли сейчас
Большинство проблем на сайте Foundation — это проблемы конфигурации, и основа построена так, чтобы сообщать о них, а не скрывать. Пройдите этот список, прежде чем предполагать проблему в проекте.
1
Запустите шлюз валидации и прочитайте сбой
Проблемы конфигурации сообщаются при сборке с указанием настройки, что решает большинство проблем сразу. README называет команды, которые выполняет сам проект.
2
Прочитайте процедуру устранения неполадок
Руководства содержат повторяющиеся сбои и их безопасные решения, включая те, что появляются после обновления сверху.
3
Проверьте, что изменилось, если вы только что обновились
Процедура обновления фиксирует, что перемещается между версиями Foundation и какие файлы принадлежат внедренцу, что объясняет большинство проблем сразу после обновления.
4
Спросите того, кто делал ваш сайт
Если кто-то внедрял или поддерживает сайт для вас, у него развёртывание перед глазами, и это самый быстрый путь к ответу.
Ни один шаг здесь не зависит от обращения в Provelopment и не сопровождается временем ответа.
Если нужна помощь, она доступна
Provelopment может предоставить внедрение, техническую помощь, поддержку и управляемые сервисы организациям, которым это нужно. Это отдельно от основы и полностью необязательно.
- Это согласуется отдельно от проекта: на этом сайте нет ничего, на что можно подписаться.
- Ни программное обеспечение, ни документация, ни работающие демонстрации от этого не зависят.
- Воспользоваться этим или решить никогда не пользоваться не меняет того, чем является Foundation.
Сначала Foundation на своих условиях, помощь — потом, если она нужна.
Что не входит во внедрение открытого кода
Честность модели помощи так же важна, как и содержащиеся в ней пути, поэтому эта страница называет границы, а не оставляет их на догадки.
- Ни службы поддержки, ни гарантированного ответа: ничто описанное здесь не обслуживается персоналом, и этот сайт не принимает запросы в поддержку.
- Ни уровня сервиса, ни реакции на инциденты, ни обязательств по доступности: развёртывание эксплуатируете вы, а программное обеспечение предоставляется без гарантий.
- Ни договора на обслуживание: принятие улучшений сверху — документированная процедура, которую выполняете вы или ваш разработчик.
- Ни закрытой документации, ни платного уровня: каждый описанный здесь документ открыт, а код под Apache-2.0.
- Ни неявных обязательств для Provelopment: необязательная помощь — отдельное соглашение о сервисе, а не условие работы программного обеспечения.
Доступны результаты работы в репозитории и, если вы выберете, отдельное соглашение о сервисе. Больше ничего не подразумевается.
Начните с того места, где ваш вопрос
Прочитайте документ, владеющий вашим вопросом, посмотрите работающую демонстрацию или пройдите путь внедрения, когда будете готовы создавать.