ここでは、リファレンスを読み解くための前提知識を解説する。
guide階層にあるページは、以下の方針のもとに執筆している。
- リファレンスを読み解くための前提知識を提供する
- 個別のリファレンスページでは、その機能の仕様を解説する。そこで前提となる概念、複数の機能にまたがる関係、機能の選び方をここで解説する
- リファレンスの各ページからは、概要の下に「概念・前提知識」セクションを設けて、この階層のページへのリンクを列挙する
- 新しいページを作る際は、まずGitHub Issueで相談する
- 無秩序に増えるとメンテナンスがむずかしくなるため、対象範囲と分類を相談してから執筆する