Open5

「エンジニアのためのドキュメントライティング」を読んでプロダクトを必要とするユーザーにもっと使ってもらう

seachickenseachicken

目的

自作した静的チェックツールが初回リリースから半年経ったが利用者がまだまだ少ないので、「エンジニアのためのドキュメントライティング」から学んだことを生かして、このツールを必要としているユーザーへ届けられるようにする。
https://github.com/seachicken/inga

読み手の理解

ユーザーのゴール

開発者及びレビュアーが Pull Request を出した時点で想定外の問題に気づくことができる。

ユーザーニーズのアウトライン

  • このプロダクトで何が解決できる?
  • どんな機能がある?
  • 簡単に性能を試したい
  • コードの漏洩などセキュリティに課題はないか?

ユーザーペルソナ

A

  • 名前: アイリス
  • 開発スキル: 上級
  • 言語: TypeScript, Java, Kotlin
  • 開発環境: MacOS, Linux
  • 役割: リード開発者

B

  • 名前: ケヴィン
  • 開発スキル: 初級から中級
  • 言語: TypeScript
  • 開発環境: MacOS, Linux
  • 役割: 初級開発者

ドキュメントの計画

seachickenseachicken

ドキュメントを書かないとなーと思いつつ実装が楽しくて後回しになる負のループ

seachickenseachicken

英語版も発信
https://dev.to/seachicken/visualizing-the-impact-of-code-changes-2kan

下記の流れで書いてみた

  1. とても雑な英文を書く(英文を想像する練習)
  2. Chat GPT 3 に読みやすくしてほしいってお願いする(まだ課金してないので 3)
  3. Grammaly で更に修正する(もはやこの時点でどこまで読みやすいかは分からないけど少し変更する)