開発のドキュメントをどこに置くか問題 - $shibayu36->blog;
最近開発用のドキュメントをどこに配置するか悩んでて、いくつか試して見てる。今回言っている開発用のドキュメントというのは、コードの触り方も含んだサービスの開発に関するもの。例えば 開発環境セットアップ方法 ページに表示している広告をどのように切り替えたりするか(googleの管理やコードの変更も含めた) サービス内の特定の機能の仕組み 内部用HTTP APIドキュメント などを指している。 結構いろいろ考えるところがあるので、思っていることをまとめてみたい。一応先に結論を言っておくと 基本は実装に一番近いところにコメントとしてドキュメント書くのが良いと思う いろんなパーツが絡みあうような大きな機能の場合、導入部分だけ別の場所に書く 出来るだけrepository内に入れておくと探しやすく、更新しやすいと思う あといろいろ悩んでるので事例あったら教えてください。 起きている問題 ドキュメントは
チリのサケ養殖について調べてみた - 最終防衛ライン3
ハフィントンポストの 日本のスーパーで売られているチリ産の鮭を地元の人が食べない理由 | 菊池木乃実 では、サケの餌､殺虫剤､抗生物質による汚染の点からチリで養殖されたサケを地元民は食べないと書かれています。 これに対して、水産商社を名乗る人が チリでサーモンは大人気の高級魚！サーモン記事のここがデマだ！ - サーモンガレッジ！ において､サケが養殖しやすい魚であることから反論しています。両者は微妙にかみ合っていないように感じられます。 ハフィントンポストは伝聞や地元民を使って自分の意見を書いている点が信用に値しないなと。一方で、水産商社の方も地元の養殖業者の声という点で信用度はどっちもどっちかなと｡ パタゴニアの人がサーモンを食べない理由は､環境汚染云々よりも地域的なものや価格的なものじゃないかなと｡アルゼンチンとの国境近いパタゴニアとサケの養殖が行われているチリの西海岸では食文化も魚介
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
