cohalのブックマーク - はてなブックマーク

読み手を意識したテクニカルドキュメントを書くために /「エンジニアのためのドキュメントライティング」を読んだ - kakakakakku blog
2023年3月に出版された「エンジニアのためのドキュメントライティング」を読んだ．原著は Docs for Developers で，翻訳を担当された @iwashi86 さんに本書を送っていただいた．ありがとうございます❗️そして出版おめでとうございます🎉 本書は今まで書いてきたテクニカルドキュメントに対して "できてなかったな〜" という気付きを与えてくれるイイ本でした📖 読みながら感じたことを大きく分類すると以下2点！印象に残ったところを中心にまとめようと思う．テクニカルドキュメントの重要さを改めて認識できた👌 テクニカルライティングという仕事（ポジション）に興味を持った👀 ユーザーの問題解決とプロダクトの成功を導く　エンジニアのためのドキュメントライティング作者:ジャレッド・バーティ,ザッカリー・サラ・コーライセン,ジェン・ランボーン,デービッド・ヌーニェス,ハイディ・
cohal 2023/03/20
リンク
CPU / メモリ / ディスクに負荷をかける stress コマンド - kakakakakku blog
最近 stress コマンドを使って，サーバに負荷をかける方法を紹介する機会があり，よく使っているのに今までブログに書いていなかったなと気付き，今回まとめることにした．CPU に負荷をかけるだけなら yes > /dev/null をコア数に合わせて並列実行すれば良いけど，stress コマンドならメモリとディスクにも負荷をかけることができるので，シナリオのバリエーションを増やすことができる． stress project page インストール検証環境として CentOS を使った． $ sudo yum install stress $ stress --version stress 1.0.4 共通オプション以下のような共通オプションが用意されている．よく使うのは --timeout で，秒数を指定して負荷をかけることができる．他はあまり使ったことがないかも． -t, --tim
cohal 2018/10/22
リンク
理論を知って改めて監視と向き合おう /「ITインフラ監視[実践]入門」を読んだ - kakakakakku blog
先週発売された「ITインフラ監視[実践]入門」を読んだ．ちょうど業務で監視改善を検討しているところだったので，個人的に良いタイミングで読むことができた．あとお世話になってる @ariarijp が本書のレビューに参加されたってことで，すぐ読んでみようと思った．監視 is 何「監視」に対する理論や定石がまとまっていて，今までに無かった視点の本だなと感じた．一部 Mackerel の例も出てくるけど，あくまで実例の紹介という感じで，導入しているインフラ技術や監視サービスに依存せず読めた．「サービスの安定稼働」って言うのは簡単だけど，そのためには多岐にわたる戦略が必要で，本来ならここまで本腰を入れて監視に向き合うべきだよなーと改めて感じたりもした．閾値 (Threshold) 「閾値」を「しきいち」と読んでいるし，今までの現場でもそう読んでいたけど，本書では「いきち」と読みが振られていた．
cohal 2016/01/25
リンク
1