2016年8月5日のブックマーク (2件)

  • いつ突然会社をやめても問題ないという基準でコードやドキュメントを書く - $shibayu36->blog;

    先に前提を話しておくと、会社は全く辞めるつもりはないし、むしろどんどん会社を良くしていこうと思っている。今回はそういう基準で自分がコードやドキュメントを書いていますよという話。 コードやドキュメントを書く時に、どのくらいきれいにしておくかとか、どのくらいわかりやすくしておくかとかを考えることがある。こんなとき僕は、いつ突然自分が会社をやめて連絡がつかなくなったとしても他の人がある程度理解できるか、を基準にしている。そのためにはあまりいい方法が思いつかなくて仕方なく書いている部分にはちゃんと経緯のコメントを書く。他にも例えば作ったサービスであるイベントを開催する方法のドキュメントを書くなら、全く何もやったことがない人がそのドキュメントを読んだらとりあえず開催できるよう、ドキュメントを書く。当然コードもかっこよさよりも、説明しなくても分かりやすくなるようなシンプルさを追求する。 また、このよう

    いつ突然会社をやめても問題ないという基準でコードやドキュメントを書く - $shibayu36->blog;
    phain
    phain 2016/08/05
  • 親子で楽しむ!ラズベリーパイ・ハンズオン | Peatix

    電子工作がんばるぐるーぷ」第一弾の企画は…夏休みの自由研究サポート!Raspberry Piをメインに夏休みの自由研究で出せそうな電子工作を作ってみたいと思います!夏休み終了間近... powered by Peatix : More than a ticket.

    親子で楽しむ!ラズベリーパイ・ハンズオン | Peatix
    phain
    phain 2016/08/05