けんちゃんくんさんのWeb日記

2021-01-28

仕事があまりうまく行かなかったのでテンション下がり気味。そんなこと言ってても問題は解決しないので、一つ一つ倒していこう！

いいウェブログがあったので、それについての感想をもって、今日の日記としよう。

今日のウェブログ

質の高い技術文書を書く方法 - As a Futurist...

riywoさんのめっちゃいい文章が公開されていた。

「文章から得られるアウトプットをまず定める」や「結論を最初に書く」というのはなるべく意識していて、最近会社で書いている短めのドキュメントは、ページタイトルで誰が何に困っているときに読む文章なのかがわかるように気をつけいているつもり。(例えば「サービスAが閲覧できない障害に対応する」といった感じ)

「箇条書きを乱用しない」というのは本当にそう。私は、箇条書きを乱用しまくるくせがあることを自覚しているので、まとまった文章を書くときは意識的に箇条書きを避けるようにしている。<ul>と<ol>の意味で表現するのが正しいと思ったときにだけ箇条書きを使うように心がけている。

一方で、ドキュメントがないよりは箇条書きであってもあったほうがいいとも思っている。この点、scrapboxは箇条書きを一級市民として扱うことで、ドキュメントを書くための心理的障壁やクオリティの底上げ(変な構造になっているよりは箇条書きのほうが構造がわかりやすい)ができるんだろうなと考えている。( 箇条書き - 橋本商会 )

最後に、この記事で重要だと言っている以下の一文の後半は、自分はあまり意識できてないところだったので、これからは(自己)レビューのときに意識しようと思う。

文書から得られるアウトプットが明確で、読み手のレベルによらず一定に伝わること

今日の読書

今日はお休み

今日の英語

今日はお休み

2021-01-27

GMOインターネットグループの在宅勤務体制への移行から今日でちょうど1年。途中で若干の変更があったり、また最近の緊急事態宣言でさらに変更があったりしたが、オフィスに行った回数は数えられる程度で、2年前までは全く想像できない働き方となった1年だった。この1年の働き方や環境の変化は、週末にでもまとめられるといいな。

今日は仕事でちょっとした問題が発覚し、だいぶ時間をかけて調査をしていたのだけど、説明はできるけどどう対処したもんかなぁと煮詰まってしまったので、明日の自分が解決してくれると信じて終わりにした。頑張れ！明日の自分！

昨日、息子が元気なかったと書いていたのだけど、今日は元気に見えたので一安心。

今日のウェブログ

今日はお休み

今日の読書

今日はお休み

今日の英語

NHKラジオ英会話のLesson 191。レッスンの内容が腰痛の話で笑ってしまった。

テキストの内容は、賛成や支持を表す表現。

ポジティブな気持ちで「やってみよう」「やって見る価値はある」というのは「it's worth a try」。「大賛成！」は「i'm all for that.」

2021-01-26

DHCのブルーベリーサプリを飲み始めて60日たっていた。去年の健康診断で、視力がびっくりするほど下がっていたのでこれはまずいと飲み始めたのだけど、今のところ普段の生活の中ではあまり変化は感じられない。もともと目がいい方だったので、なんというか、老いなんだろうと思ってはいるのだが…

朝はエンジニアリングマネジメント学習会シーズン2。今日はドキュメンテーションについて、みんなで議論できてよかった。

夜は所要があったので少し早めに仕事を切り上げて、用事をこなすなど。

そういえば、息子が帰ってきてからずっと体調が悪そうだったので心配。明日には元気になってるといいのだが。

今日のウェブログ

マネジメント業を通じて考えた、プロジェクト全体像の認識齟齬を防ぐ誤解されないドキュメント作成術 - ANDPAD Tech Blog

ドキュメントの書き方について、MECEを意識することが大事という話だと理解した。また、その実例もあり、よい記事だった。

一方で、ドキュメントは2次元、平面上のものであるというのは、現状の仕組みがそうであることと、それ前提で人間の認知に限界が作られてしまっているという話であって、3次元空間や時間といった軸をうまく表現できるツールが生まれたら状況は変わるだろうと思っている。し、そうなってほしいと願っている。

今日の読書

SRE本の7章を読んだ。自動化というのはソフトウェアのためのソフトウェア、つまり「メタソフトウェア」であるというのがとてもよかった。新しい語彙をもらえて最高。

また、k8sを身近で使うようになって、以下の文の意味がようやくわかってきた感覚があった。

システムが手動、自動、自律、という階段を上がっていくにつれて、自己検査のための能力がないと生き残れないのです。

今日の英語

今日はお休み。Duolingoで中国語を30xpだけ。

2021-01-25

先週の後半から腰痛が再発して、土日は完全に静養モードになっていた。今朝も調子が悪く、このまま仕事しても気が散って無理そうだったので午前中は有給をとること。ご飯を食べてからロキソニンもぐもぐして休んでいた。

午後からは薬も効いて復活してきたので仕事開始。進めなきゃいけなかったものが少しは進んだのでよかった。

また、pepabo/active_merchant-epsilonをGitHub Actionsへ移行するやつや新バージョンのリリースをレビューしてもらってマージ。gemのリリースはまだ温かみのある手作業なので手元からrake releaseを打ってリリースしておいた。

今日のウェブログ

esm7/obsidian-vimrc-support: A plugin for the Obsidian.md note-taking software

obsidian.mdでvimキーバインドを使えるようにする拡張。Kinesisのときはカーソルキーでの移動でいいんだけど、ラップトップのキーボードを使うときにあると便利なのでインストール。ノーマルモードに戻るときにIMEをオフにするのとかはできるかまだ見てないけど、普通に使う分には十分っぽい。

Foam | A personal knowledge management and sharing system for VSCode

Roam ResearchっぽいことをVSCode上でやるExtensionとそのテンプレート。VSCodeの拡張と組み合わせられるから確かに便利かもなと思って見ていた。

今日の読書

腰痛のためお休み。

今日の英語

同じく腰痛でお休み。Duolingoで中国語を少しだけやっただけ。文法がわかってないので「我姓王」というのがどういう文型なのか理解できてないのだけど、繰り返しやっていくと語の並びで読めてくるのは不思議。

2021-01-21 いい紅茶を買ってもらった

WFHの日常になってから、飲み物をどうするかという問題に悩まされている。それを見かねた奥さんがちょっといい紅茶を買ってきてくれた。30種類が1つずつ入っているので、初日は一番ふつうっぽい「5000 ダージリン・ザ・ファーストフラッシュ」というのを飲んでみた。今まではリプトンの三角形のやつで生活してきたので、それと比べると確かに香りもいいし、説明の通り爽やかな渋みで美味しかった。これが「分かる」ということかぁ。

これにより、朝はコーヒー、昼からは紅茶、夕方から寝る前はカフェイン入ってないもの(冬ならホットミルクやホットレモネードなど)というサイクルを作れそうなので、ルーチン化してやっていこうと思う。

今日のウェブログ

短縮URLにFirebase Dynamic Linksを利用している - Glide Note

独自ドメインで短縮URLを作る方法。特にインターナルなリソースの短縮URLがほしいことがあるので、会社でも使えると便利なのかもなぁ。

Productivity - Golden Kitty Awards 2020 | Product Hunt

Obsidian.mdがProductHuntのAward(Productivity部門)にノミネートされたそうなので、Productivityに関する他のプロダクトもみてきた。気になったのがいくつかあったのでメモっておく。

Productivity部門以外も面白そうなのがたくさんあるので後でみてみる。

今日の読書

「行動経済学の使い方」を読み終えて、「スケーラブルデータサイエンス」を2章の途中まで読んだ。実際に手を動かす本なので、土日にエイッと進めようかな。明日からはSRE本に復帰する予定。

今日の英語

お風呂に入りながらラジオ英会話のLesson 188を聞いたけど全然聞き取れなくてがっくり。先月も出ていたというイディオム「on the same wavelength(同じ波長で->同じ認識で)」が面白かった。

We are on the same wavelength!