編集方針
編集方針
書くのは、自分の環境で実際に試したことだけ。数字もエラーの文言も、作業中の記録から書き写します。
01
自分でやったことを中心に書く
記事の中心は、自分の PC で実際に試した結果です。かかった時間、エラーの文言、使ったバージョンは、作業中に取った記録から書き写しています。試していないことを、試したように書くことはしません。
02
環境と確認した日を書く
AI の開発ツールもゲームエンジンも、数週間で挙動や料金が変わります。そのため記事には、OS やツールのバージョンと、確認した日付を載せています。古くなった情報に気づいたら更新し、更新した日を記事の上に出します。
03
結論から書く
記事の冒頭に要点を置き、検証した環境、よくある質問、出典までを同じ形でそろえています。知りたいことに最短でたどり着けることを優先しています。
04
出典を示す
料金や仕様など、自分で測れないことは公式のドキュメントや発表を確認し、リンクを付けています。公式の情報同士で食い違っているときは、そのことも書きます。
05
失敗も残す
うまくいかなかった手順や、遠回りしたところも消さずに残しています。同じところで困っている人には、そちらのほうが役に立つと考えているからです。
06
再現できる範囲と、評価していない範囲を分ける
「作り方」の記事には前提・操作順・期待する結果・失敗時の確認先を用意します。コードの断片と動かせるサンプルは区別します。自動テストの成功は面白さの証明ではなく、PC上のスマホ幅は実機ではありません。 制作記録・実測・公式情報も混同しません。
記事の誤りはお問い合わせフォームから教えてください。確認して直し、内容が変わる修正なら更新日を改めます。