今まで型定義を自前で用意していたのですが、自動で生成するライブラリを使うことにしました。

contentful-typescript-codegenを使う方法を最初試していたのですが、メンテナンスがあまり活発でないことと、Contentfulのv10のアップデートに失敗してしまうことがわかりました。これから対応する方は注意してください。

型情報を含んだjsonを読み込んでTypeScriptの型を作るので、まずはそのjsonを作る準備をします。contentful-cliを使います。

1npm install -D contentful-cli

jsonを作るスクリプトをpackage.jsonに追加します。export-confing.jsonを別で作り、そこに設定値を入れます。この設定値には公開したくないアクセストークンをいれるので、gitignoreに入れてコミットしないようにします。

ちなみにｍanagementTokenはCMA tokensからPATを作成することで取得しました。

1{
2  // ...
3  "scripts": {
4    "contentful-export": "contentful space export --config export-config.json"
5  }
6}
7

1{
2  "spaceId": "XXXX",
3  "managementToken": "CFPAT-XXXX",
4  "contentFile": "contentful-export.json",
5  "skipContent": true,
6  "skipRoles": true,
7  "skipWebhooks": true,
8  "skipTags": true
9}

npm run contentful-exportを実行することで、型データのjson（contentful-export.json）が作られました。

次にこの型データjsonからTypeScriptの型を作ります。cf-content-types-generatorパッケージをインストールします。

1npm install -D cf-content-types-generator

package.jsonに以下のスクリプトを追加します

1{
2  // ...
3  "scripts": {
4    "contentful-generate-types": "cf-content-types-generator contentful-export.json -o ./@types --v10 --response"
5  }
6}

スクリプトを実行することで型が生成されます

1npm run contentful-generate-types

これで型が生成されました。これで安全に開発ができます。

X(Twitter)もGitHubも全てeityansで統一しているし、せっかくなのでドメインも取得してみました。

Cloudflareで取得。年10$ほどで、それぐらいなら良いかなと思いました。

電車移動中にふと欲しくなったのでその場で取得。帰宅してからこのブログに設定しました。

このブログはVercelにホスティングしており、設定画面のドメインからポチポチするだけで反映されました。便利。

具体的に設定したこと

Cloudflare側

• DNSSECの有効化

  • キャッシュポイズニングなどのDNS攻撃を軽減することができます

  • データにデジタル署名することで、データの有効性を確保し、攻撃から保護します。

  • データが大きくなるそうですが、有効化するメリットのほうが大きそうです。

• SSL/TLS 暗号化

  • フルがおすすめとのことなので、フルに設定しました

Vercel側

• ドメインの追加

  • Settings→Domains→Addから今回取得したドメインを追加しました

  • Cloudflareにリダイレクトされ、良い感じに連携してくれました

  • 反映されるまで数分かかりました。

• 元のドメインのリダイレクト設定

  • 「blog-eityans.vercel.app」というドメインが割り振られているので、これをeityans.comにリダイレクトさせる設定をしました。

完全リモートの会社に転職して１年半近く経つ。

やり取りは全てSlack。文字だけのコミュニケーションで、会議と言えるものは朝会で一日5分程度。あと面接ぐらいか。同棲していなかったら一言も話さないこともありそう。

仕事を進めるうえで調整しなければならないことが発生したときも全てSlack。突発な会議や打ち合わせは行ったこと無い。それで仕事が進むのかと思う人もいるかも知れないが、案外進むものだ。

かなり極端な会社にいると思う。自分なりにテキストコミュニケーションだけで仕事を進めるメリットとデメリットを考えてみる

メリット

• 仕事を邪魔されない

  • こういう言い方をすると新しく入ってきた人などがコミュニケーションを取りにくくなりそうだが、ここではシンプルにこう言い切る。同期的なコミュニケーションは要求する側にはメリットがあるが要求される側にはあまりメリットがないのだ。

  • 逆に、質問する側からすると仕事を邪魔する気後れみたいなものが無いのも良い。

• 透明性

  • 誰が何に困っているのかがわかるし、誰がそれに対応しているのかもわかる。評価をする面でそれらがわかるのは良い。

• 後世に残る

  • 文字に残ることで他の人に知見がいきわたる。

• 考えが整理される

  • 瞬発的な会話を要求されないため、じっくり検討することができる。やり取りの濃度が上がる

• 自己解決することがある

  • 考えが整理され、結果として自己解決することもある。

デメリット

• 考えをテキストに起こすのに時間がかかる

  • これは慣れの問題もありそう。ただ、何に時間がかかるのかといえば考えを整理するところが大部分だと思うので、かつそれをあらかじめ整理するのは同期的だろうが非同期だろうがすることではないだろうか。

• リードタイムがかかる

  • 性質上しょうがない。それを踏まえて各自が行動するのが望ましい。確認することは早めに確認し、回答を待つ間に別の作業を行うなど。

  • 回答する側は、ひとまず目は通しましたということや、今は回答できないことだけでもすぐに伝えたほうが良い。それだけで質問側のフラストレーションがかなり下がる。

• 考えをテキストにまとめるのが苦手な人がいる

  • 国語の能力だったり、論理的思考力の話になる。得意不得意があるものだが、繰り返し練習すれば伸びるもの。重ねて言うが、得意不得意がある部分なので、苦手な人を努力不足と安直に判断するのは控えたほうが良い。

• テキストでのコミュニケーション自体が苦手な人がいる

  • テキストはそっけなく見えてしまいがちで、その影響を忘れがち。

  • ある程度は慣れてもらうしか無い気がするが、そういう人もいるのは念頭においておきたい。

デメリットを小さくするために

メリットとデメリットを見ると、メリットは組織やチームに関係し、デメリットは個人に関係していることに気付く。であるならば、個人の改善が大いに効果を発揮するだろう。以下を意識する。

• 質問を受けたらすぐに反応する

  • これは回答を含まなくても良い。あとで回答することを伝えるだけでも良い。

• 絵文字や「！」をつける

  • おじさん構文になっても良い気がする。無機質な感じを減らせる。

RSSリーダーを地味に使っている。全ての記事を追うつもりはないが、たまに見ると気になるブログが更新されたりしていて面白い。

移行方法はあるのかもしれないが、いまいちすぐに方法を見つけられなかった。面倒だが、せっかくなのでこれを機に購読するサイトの整理をした。

整理してみると面白く、自分の関心事が移っていることがわかった。例えばCSS周りのテクを紹介するサイトは移行しなかった。転職する前はフロントエンドの細かい実装も行っていたが、今の職場はそれらができるデザイナがいる。彼に任せればよくなったので、そのあたりを追いかける必要性が薄くなったりしている。

他にも、逆に何年も更新していないブログを見て、この人は今どうなっているんだろうと思いを馳せたりした。逆に、もしかしたらこのブログに対して同じようなことを考えている人がいるかもと思い、このできことを書いてみることにした。

移行作業は最初は面倒だと思ったが、自分やいろんな人が変わっていることを感じて案外面白かった。作業自体は1時間程度。定期的に整理するのは今後もやってみようと思った。

随時更新していく。上に行くほど最近読んだ本。

前に書いたこの内容をより充実させた感じ。同意しかない。

5/2 読了

1,2年目ぐらいの人が読む本だなと思い、途中から流し読み程度に読んだ。そりゃそうだよねーという内容が書かれているので、新しい発見はあまりなかったかも。

ただレビューのコミュニケーションの話はとても良くまとまっていて、人に教えたりするときに使えるかも

4/29読了

SOFT SKILLSを書いた人の本。名前の通り、キャリアについて深く考えた。

4/17 読了

名著。中身ももちろん良かった。至極真っ当なことを述べている。読みながら反省することが多い本。

人を動かすというタイトルだが、より正確に言うならば、「相手の立場や意見、感情を一番に尊重し、相手が自発的により良い方向に気持ちよく行動させるための方法」を教えてくれる。

原則は相手に重要感を与えること。自分はそういうトーンで仕事を依頼したり会話をしたりできているだろうか。言い方だけの話ではなく、相手のことを自分がどう見るのかを教えてくれる本なので、この本から得た視点で人を見ていきたい。

相手を議論や結果で打ち負かしたとき、自分は気持ちいいかもしれないが、相手の気持ちはどうだろうか。そういう短期的な快楽を自己中心的な理由で選択するのは得策ではない。振り返ると、それぐらい相手に譲ってやれよという場面がいくつかある。相手の誤りを指摘することは正しいかもしれないが、合理的とは言えない。

自分はどれだけ人のことを褒めているだろうか、今日から褒めていきたい。

3/30 読了

本の存在は知っていたが読んでいなかった本。第二版があるとのことなので読んでみた。

もっと早く読めば良かったかもしれないし、今読んでちょうどいい本だったかもしれない。

この本を読んですぐに行動を変えようと思ったことが二つある。一つはブログを継続的にメンテしようと考えた。ドメインを取得したのもそのせいだ。放置していたら叱ってほしい。二つ目はポモドーロ・テクニックだ。今日が日曜日なので、明日の仕事で活かすのが楽しみ。

読んで良かった。

3/16読了

話題になっているので読んだ。リーダブルコードのような本かと思ったが、コードの整理方法を紹介すると言うよりは、コードを整理すること前提で行動して過度なコストを払っていないだろうか？という気づきを与えてくれる本。

本書曰く整頓はプリングルスのようなもので、少し始めるとどんどん止まらなくなるものらしい。すごくわかる。それによってPRが肥大化するのもわかる。かといって整理しないのも将来の負債だし。

整頓周りの要バラをより深く考察している本。

整頓の顧客は自分自身という言葉も響いた。整頓はある意味自己満足かもしれない。とりあえず何でもかんでも整理することはなくなりそう。

3/8 読了

ドキュメンテーションの重要性は常々思っている。特に今の会社ではフルリモート&非同期コミュニケーションがほとんどなのでその思いは強くなっている。

社内で共有して同じ考え方や近い考え方で行動できるようにしても良いかもしれない。

3/4 読了

一日であっという間に読んでしまった。

2/6 読了

世界史の勉強をしたことがないので、教養として読んだ。

権力が集中すると荒れてコケるパターンが本当に多い。二枚舌外交の意味を知った。

2/2 読了

難しい。ただ確実に一つ上のレベルに引き上げてくれる。

定期的に読み返す予定。トーナメントの章を読んで久しぶりにトナメやりたくなってきた。

1/27 読了

哲学ブーム来てる。自分は哲学については全く知らなかったが、とても楽しく読めた。

歴史上の様々な哲学を紹介している。なぜその考えが生まれたのかの説明と、その考えの内容が次々に展開される。その結末は予想外だった。面白い時代に生きているのだと思う。

1/18 読了