最近開発用のドキュメントをどこに配置するか悩んでて、いくつか試して見てる。今回言っている開発用のドキュメントというのは、コードの触り方も含んだサービスの開発に関するもの。例えば 開発環境セットアップ方法 ページに表示している広告をどのように切り替えたりするか(googleの管理やコードの変更も含めた) サービス内の特定の機能の仕組み 内部用HTTP APIドキュメント などを指している。 結構いろいろ考えるところがあるので、思っていることをまとめてみたい。一応先に結論を言っておくと 基本は実装に一番近いところにコメントとしてドキュメント書くのが良いと思う いろんなパーツが絡みあうような大きな機能の場合、導入部分だけ別の場所に書く 出来るだけrepository内に入れておくと探しやすく、更新しやすいと思う あといろいろ悩んでるので事例あったら教えてください。 起きている問題 ドキュメントは
こんにちは。技術部 開発基盤グループの諸橋です。 クックパッドでは昨今の多くのWeb企業と同じように、GitHub EnterpriseのPull Requestを使ったコードレビューを広範に実施しています。わたしたちのコードレビューでは、ソースコードの字面にとどまらず、サービスの機能として魅力的かどうかや、保守性を含めた設計が適切かといった議論に発展することも良くあります。 きょうはそんななかで話題に上がった「現在時刻」の扱いかたに関する設計の話を書きます。 背景 サービスを開発・運営している我々には、時間帯によって出し分けたり、特定の期間のみに表示したいコンテンツがたくさんあります。 そのたびにデプロイし直すというのはつらいので(特に24:00に出なくなるコンテンツなど)なんとかしたくなりますが、一方で時限式のコンテンツはその時になるまでちゃんと動いているか確証が取れないので怖いです。
船員さんの高齢化がマジでヤバイ。 どんぐらい足りないかって言うと年金生活したい船員さんを土下座して引き止めるくらい。 会社はいえないけど80歳の船長さんがいるくらいだし噂じゃ90代もいるらしい。 統計で見ると50歳以上が全体の56%で60歳以上も25.2%って状態。 内航海運は日本の物流の半分を担ってるのに若い人が全然来てくんない。 いや来るけどすぐやめちゃう。なんでかというと ・激務(航行と荷役ができるギリギリの最少人員で常に回しているので一人あたりの負担がでかい)※ ・3ヶ月乗船1ヶ月休暇という勤務形態が不人気 ・の割に給料あんまり良くない(上の要因の割に合わない、金額だけで見たらそこそこ良い) ・上述のように狭い船内でお爺ちゃんとおっさんと同世代がいない中で3ヶ月間顔つき合わせて働く が理由。 まあカネさえあれば、乗員の数も増やせるし、給料もよく出来るんだけど 荷主がマジで鬼のように
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く