タグ

ブックマーク / moznion.hatenadiary.com (6)

  • 最近の社内Wikiの書き出し - その手の平は尻もつかめるさ

    最近,社内Wiki書く時にその記事の頭に「この記事で分かること」というセクションを持ってくるようにしている.こんな感じ. wikiのページを開いた時に真っ先に「どういう情報が得られるか」が書いてあると,取捨選択を早い段階から行えるので調べ物のスピードが上がって良いような気がしている. あと所属している組織ではConfluenceを使っていて,Confluenceの検索機能に引っかかるような (引っかけやすいような) ワードを「この記事で分かること」に含めるように心がけている. 地味に便利になりつつある気がしている. [追記] そう言えばConfluenceの検索結果は「タイトル」と「サマリ」が出るんだけど,冒頭にこういう情報を書いておくとそれがサマリ部分に表示されるから,検索結果一覧の段階から情報の取捨選択できて便利というのもあった.

    最近の社内Wikiの書き出し - その手の平は尻もつかめるさ
    mfks17
    mfks17 2016/11/21
  • 「UNIXという考え方」を読んだ - その手の平は尻もつかめるさ

    「UNIXという考え方」をAmazonのwish listに入れていたらid:kenjiskywalkerさんが贈ってくださったので読みました.お陰でUNIXという考え方を学べました.ありがとうございます! 書では一貫して「プログラムを小さく作る」という事と「1つのプログラムには単一のことだけを上手くやらせる」という事について言及されています. プログラムを小さく作るということによって,そのプログラムはコンピュータのリソースに対して優しくなり,なおかつ巨大なプログラムと比較して人間が理解するのが簡単になるので保守がしやすくなり,かつ他の部品と組み合わせやすくなるという論旨です. プログラムを小さく作ると,必然的にそのプログラムは多くの責務を負えなくなる為,自然とプログラムは単一の機能のみを持つようになります.従ってこれら2つの考え方は対になっていると言えるでしょう. 書で言われている「

    「UNIXという考え方」を読んだ - その手の平は尻もつかめるさ
    mfks17
    mfks17 2014/04/01
  • 「Webアプリエンジニア養成読本」を読みました - その手の平は尻もつかめるさ

    Perlの話がほぼ出てこないこのはクソ!!!!! (嘘です.著者の1人にそう書けって言われたものだから……) Webアプリエンジニア養成読[しくみ、開発、環境構築・運用…全体像を最新知識で最初から! ] (Software Design plus) 作者: 和田裕介,石田絢一(uzulla),すがわらまさのり,斎藤祐一郎出版社/メーカー: 技術評論社発売日: 2014/03/11メディア: 大型この商品を含むブログ (2件) を見る Webアプリの着想・設計・制作・運用までバランスよくまとまっていて良いだと思いました.この手の書籍で運用にまつわる話が載っているのは中々珍しい気がします. 1章 基的なWebの技術 (HTTPとかServer-ClientアーキテクチャとかHTMLとか) の説明が優しく,わかりやすくて良いです.僕もWebアプリ触り始めの頃にこれを読めれば!!!! と

    「Webアプリエンジニア養成読本」を読みました - その手の平は尻もつかめるさ
    mfks17
    mfks17 2014/03/19
  • Ukigumoの新機能一覧 - その手の平は尻もつかめるさ

    https://metacpan.org/pod/Ukigumo::Server https://metacpan.org/pod/Ukigumo::Client https://metacpan.org/pod/Ukigumo::Agent ゆるふわCIエコシステムのUkigumoですが,最近ひと通りアップグレードしたのでそれに伴って搭載された新機能について紹介します. 注意 Ukigumo::Server 2.0.0以降はDBのスキーマが変更されているので,テーブルのALTERが必要です. ALTER TABLE report ADD compare_url VARCHAR(255) DEFAULT NULL; などとしてやる必要があります. Ukigumo::AgentがGitHubのWebhooksに対応した /api/github_hookにGitHubのWebhookを飛ばして

    Ukigumoの新機能一覧 - その手の平は尻もつかめるさ
    mfks17
    mfks17 2014/03/19
  • chef-jubatus を書きました - その手の平は尻もつかめるさ

    https://github.com/moznion/chef-jubatus 色々と必要に迫られたので書きました。 Chef の詳しい事とか難しい事とか、あんまり分からないのでrecipe にベタァッと書いてます。 なんだか良くない予感がしますね!!!! とりあえず、run_list にrecipe[jubatus] を加えてやるとjubatus をインストールしてくれるはずです。 Red Hat Enterprise Linux 系のOS とDebian 系のLinux だと動くと思います。 Pull-Request 等、目下募集中です!

    chef-jubatus を書きました - その手の平は尻もつかめるさ
    mfks17
    mfks17 2013/05/12
  • 米国人からコーディングについての怒りのメールを頂戴した - その手の平は尻もつかめるさ

    "米国人からコーディングについての怒りのメールを頂戴した" の補足 - その手の平は尻もつかめるさ ↑の方で補足いたしました。(2012.09.04 追記) 最近、英語のメールでよく怒られます。moznion です。 海を隔てて共同作業しているアメリカ人から、僕のコーディングについてお叱りのメールを頂いたので、 自戒の念を込めて邦訳して記します。 書いてあることは「当然」とも言うべき内容ですが、僕はその「当然」も守れていなかったのかぁ〜と反省。 以下、邦訳(意訳)です。 1. 郷に入っては郷に従え 既にソースコードが存在しているって事は、そこには同時にコーディングスタイルも存在しているってことだ。 その既存のソースコードに手を加える場合、別のコーディングスタイルを導入してはならない。 もし君がバックエンドのソースコードを弄っているなら、バックエンドのコーディングスタイルで記述するんだ。 フ

    米国人からコーディングについての怒りのメールを頂戴した - その手の平は尻もつかめるさ
  • 1