ヘルプ
依存のない支援
Foundation は自分で支援できるように設計されており、支援のモデルもそれを反映しています。Foundation のサポート窓口はなく、開設するアカウントもなく、このサイトにお問い合わせフォームもありません。存在しないサービスを作り出すことになるからです。実際に利用できるものを以下に示します。
- ドキュメントは公開リポジトリでコードと一緒に配布されるため、説明対象から離れることがありません。
- 自分で進める、自社の開発者や代理店を使う、Provelopment の任意の支援を使う、という 3 つの正規の方法があり、推奨の優劣はありません。
- ここに書かれた内容はどれも制限されておらず、このページは応答時間を約束しません。
支援を得る 3 つの正規の方法
実際に取られる方法であり、どれも同じように有効です。このページはどれかを特別扱いしません。どの方法でも到達するサイトは同じです。
自分で支援する
公開リポジトリが Foundation の主要な支援経路です。ドキュメントは流し読みではなく手順として従えるように書かれ、説明対象のコードと同じ版で管理されています。
- README、カスタマイズの手引き、アーキテクチャのドキュメント、デプロイ手順書、各種手引きがそれぞれの分野を担います。
- 検証ゲートはビルド時に設定の問題を設定名付きで報告するため、多くの問題はその場で解決します。
- 何も留保されていません。ドキュメント、コード、動くインストールを有料プランの背後に置いていません。
自社の開発者や代理店を使う
導入で変更すると想定されるものはプラットフォームのコードではなく設定、コンテンツ、アセットにあるため、Foundation を見たことがない開発者でも引き継げます。
- 引き継ぎは属人的な知識に依存しません。所有権の境界とアーキテクチャは文書化され、テストがその境界を強制します。
- 初見から生産的になる最短経路があり、長さはドキュメント 2 つ分です。
- Foundation サイトの運用、変更、公開のどこにも Provelopment の関与は必要ありません。
Provelopment に尋ねる
Provelopment は、希望する組織に対して導入支援、技術支援、サポート、運用サービスを提供できます。それは基盤とは別で、完全に任意です。
- Foundation はそれを要求せず、ソフトウェアのどこもそれに依存しません。
- プロジェクトとは別に取り決めます。このサイトはサポート窓口や販売窓口ではありません。
- Foundation を導入し、自分で公開し、Provelopment に一度も連絡しないことは、完全に成功した結果です。
どれも推奨される方法ではありません。支援を受けるか受けないかはサービスの判断で、ソフトウェアを変えずにいつでも選び直せます。
答えを持つドキュメント
技術的な質問はリポジトリで、答えが説明するコードの隣で扱われます。以下はいずれもその分野の権威であり、このページが繰り返さない理由です。
README
プロジェクトの内容、始め方、リポジトリの構成、実際の検証コマンド。
CUSTOMIZING.md
下流利用者のための手引きと設定の完全なリファレンス。あなたのものとプラットフォームのものを分ける表を含みます。
ARCHITECTURE.md
アーキテクチャのスタイル、境界、依存の向き、連携のパターン。
DEPLOYMENT.md
リリース手順書：最初の公開、継続的インテグレーションの保護、独自ドメイン、公開後の確認。
BRAND_ASSETS.md
ブランドアセットの差し替え契約：置き換え可能なすべてのビジュアルの役割と順序。
instruction-manuals/
手順：導入、カスタマイズ、ブランド、コンテンツ、検証、デプロイ、更新、トラブルシューティング。
troubleshooting.md
繰り返し発生する不具合と安全な解決方法。更新後に現れるものも含みます。
このサイトとリポジトリが食い違う場合はリポジトリが正しいです。このページはどこを見るかを示し、作業はリポジトリが担います。
どの質問にどの情報源が答えるか
多くの訪問者は少数の質問のどれかを持って来ます。それに答える場所を挙げます。どれもアカウントや会話を必要としません。
Foundation とは何で、何を提供しますか？
範囲、境界、各部分の振る舞いについてのプロジェクト自身の説明。
技術的にどう構成されていますか？
層、依存の向き、テストで強制される境界。
自分のビジネスにどう合わせますか？
身元、ブランド、コンテンツ、辞書、アセット、そしてあなたが変更できるファイル。
どうやって公開しますか？
デプロイ手順書：最初の公開、独自ドメイン、その後の確認。
完成した Foundation サイトはどんなものですか？
同じ基盤から作られ、コンテンツ、身元、ナビゲーションが異なる 2 つの稼働中のデモ。
自分のサイトで何か問題が起きています。
トラブルシューティングの手順は、実際に繰り返した問題とそれぞれの安全で実績のある解決方法を持ちます。検証の手順は、確認が通るとはどういうことかを定義します。
実装や維持を他の人に任せたい。
Provelopment 自身のサイトが提供内容を説明しています。その取り決めはプロジェクトとは別です。
このページは手引きを意図的に転載しません。参照するだけにして、各回答がただ 1 つの権威を持つようにしています。
今つまずいている場合
Foundation のサイトで起きる問題の多くは設定の問題であり、基盤はそれを隠さず報告するように作られています。プロジェクトに問題があると考える前に、この一覧を確認してください。
1
検証ゲートを実行して失敗を読む
設定の問題はビルド時に設定名付きで報告され、多くの問題はその場で解決します。README はプロジェクト自身が実行するコマンドを示しています。
2
トラブルシューティングの手順を読む
手引きは繰り返し発生する不具合と安全な解決方法を扱い、上流の更新後に現れるものも含みます。
3
更新直後なら何が変わったかを確認する
更新の手順は、Foundation の版の間で何が移動し、どのファイルが導入者のものかを記録しており、更新直後の問題の多くを説明します。
4
サイトを作った人に尋ねる
誰かが実装や維持を担当しているなら、その人はデプロイを目の前に持っており、最も速い答えへの経路です。
ここのどの手順も Provelopment への連絡を必要とせず、応答時間も伴いません。
支援が必要なら利用できます
Provelopment は、希望する組織に対して導入支援、技術支援、サポート、運用サービスを提供できます。それは基盤とは別で、完全に任意です。
- プロジェクトとは別に取り決めます。このサイトに登録するものはありません。
- ソフトウェア、ドキュメント、稼働中のデモのどこもそれに依存しません。
- 利用しても、決して利用しなくても、Foundation が何であるかは変わりません。
まず Foundation をそれ自身の条件で、支援は必要ならその後で。
オープンソースの導入に含まれないもの
支援モデルの正直さは、そこに含まれる方法と同じくらい重要です。このページは解釈に委ねず、限界を明示します。
- サポート窓口も応答保証もありません。ここに書かれた内容は有人で運用されておらず、このサイトはサポート依頼を受け付けません。
- サービスレベル、インシデント対応、可用性の義務はありません。デプロイはあなたが運用し、ソフトウェアは無保証で提供されます。
- 保守契約はありません。上流の改善の取り込みは、あなたか開発者が実行する文書化された手順です。
- 制限されたドキュメントや有料プランはありません。このページで説明するドキュメントは公開され、コードは Apache-2.0 です。
- Provelopment への暗黙の義務はありません。任意の支援は別個のサービス契約であり、ソフトウェアの動作の前提条件ではありません。
利用できるのはリポジトリの成果物と、選んだ場合の別個のサービス契約です。それ以外は示唆していません。
質問のある場所から始める
質問を持つドキュメントを読むか、稼働中のデモを見るか、作る準備ができたら導入の道筋を進めてください。