GitHub Actionsを使ってテックブログの執筆を省力化する

ツール導入前の課題

GitHub Actionsを用いた運用を開始するまで、テックブログを公開するにあたり以下の手順を実施していました。

1. Notion上で執筆を行う
2. CTO, 上長がNotion上でレビューをおこなう
3. Mediumのアクセス権をもらい、入稿を行う
4. テックブログ運営チームがFigmaでOGP画像を作成する
5. 公開

この運用では3つほど課題がありました。

1. 指摘したレビューがどのように修正されたかがわかりにくい
2. てにをはの指摘など毎回同じようなレビューが発生し、レビュワーの負担が大きい
3. OGPの作成をFigmaの編集権限があるひとに毎回依頼する必要がある

どのような状態を目指していたか

公開前の定型的な作業や公開作業の自動化、記事作成からレビュー・公開までのプロセスを整備し仕組みに落とし込むことで、運営メンバーなしでも執筆・公開ができる状態を目指しました。

GitHub Actionsを使うことで公開にあたって必要な作業の多くが自動化され、定型作業が減り執筆のサポートなどに時間を使うことができるようになりました。 また、記事の管理と公開までの仕組みを同じプラットフォーム上で完結することができるので、管理が楽になりました。

導入前に解決したかった課題は以下のように解決されました。

1. 指摘したレビューがどのように修正されたかがわかりにくい
   GitHubのPR上でコードレビューを行うため変更が差分として残るようになりました。また、Suggestion changedの機能を使うことで修正してほしい内容を伝えやすく、取り込みやすくなりました。
2. てにおはの指摘など毎回同じようなレビューが発生し、レビュワーの負担が大きい
   GitHub Actions上でtextlintをかけることで、てにおはの指摘を自動化できました。
3. OGPの作成をFigmaの編集権限があるひとに毎回依頼する必要がある
   GitHub Actions上でCloudinaryのCLIを実行し、OGP画像を自動生成することで、画像の生成にFigmaの編集権限を持つ人が不要になりました。

執筆プロセスを定義しGitHub Actionsを活用した自動化を導入した結果、執筆体験の向上に繋がり、不定期に月1,2本程度公開していたブログの投稿頻度が毎月3本定期的に公開できるようになりました。

GitHubでの記事管理に対応しているブログツールでないと自動化の観点で選定できなく、選択肢が少なかったのが難しい点でした。

GitHubでの記事管理に対応しているブログツールの例

• はてなブログ
• Zenn

当初enechainのテックブログのポスティングにつかっていたMediumは、GitHubでの管理に対応しておらず、ポスティング先も同時に変える必要がありました。

テックブログの運営において、エンジニアが普段使っているツールでプロセスを作成・運用することで、作業の効率化だけでなく執筆体験の向上につなげることもできました。