nDiki : アジェンダ

ドキュメンテーション大全

プロジェクトの後半で納品用ドキュメントの整備を始めるのだが、その時はたいがいもう切羽詰りはじめていて構成やら体裁やらマネジメントやらを工夫する余力が無かったりする。 ついつい(次回は改良しようと思っていつも思っている)前回のプロジェクトの手法を踏襲してしまいがちだ。 ともすれば劣化コピーになりかねない。

やはり、忙しくても日頃からの改善は重要である。

最近はアジェンダ・議事録・開発メモなどを、積極的に Wiki や Subversion で共有するようにし、その点では以前より改善してきている。

今後はさらに、出荷ドキュメントのレビュープロセスなどを確立し品質を高めていきたいところである。 現状でもチームメンバでのピアデスクチェックやパスアランドを非形式的に行っているのだが、「チェックの程度」やその後の「修正」および「修正の確認」については、まだなんとなくやったかなという具合。この辺りを工夫したい。

先月発売されていて気になっていた「開発の現場 Vol.003」に、何かヒントがあるかなと思って買ってみた。

• 開発の現場 Vol.003 効率UP&スキルUP ドキュメンテーション大全

パラパラと見た感じではテクニカルライティングの話はあまりなく、主にソフトウェア開発における中間成果物としてのドキュメントや開発者間ドキュメントをどうとりまとめていくかという話が中心のよう。 Wiki による開発資料のライトな共有など、うちのチームでも進めている話など。

「(最初から)完全なドキュメントを書こうとしない」というのはもっとも。 状況はほとんどの場合変わるし、最初の段階では未確定の部分も多い。 だからといって、いつまでたっても手元で温めていてもしょうがない。

技術的な話では Perl の Pod を活用しようという話。 Perl 以外の言語のコメント中に Pod 形式でドキュメントを書こうという提案や、Apache で動的に Pod ドキュメントを整形しようという話とか。

テキストフォーマットとしての Pod は =over / =item / =back によるリスト表現など、最近のフォーマットに比べてすごく読み易いわけではないが、たしかに他の言語のコメントに埋め込んでおいて処理するのは、標準の Pod 関連のモジュールでできるな。

自分も Pod でドキュメントを書くけれど、(Perl 以外は) 個人的には reStructuredText にしたいと考えている。 ただ Pod みたいに他のテキストの一部に埋め込んでその部分のみ処理する記法およびツールがが標準の reStructuredText / Docutils には見当らない。 実はどっかにあるのだろうか。

---

[ 読書ノート ]

いまいちパッとしなかった「ふりかえり」

開発プロジェクトの一つが一区切りついたので、時間を作って「KPT ふりかえり」を行ったのだがイマイチ盛り上がらなかった。

問題点:

• Try 項目がカイゼンではなく、To Do に対するアクションになりがちであった。
• Try 項目が Problem 項目の裏返し (～ができていない → ～をする) で、具体的アイデアに乏しかった。

原因としては以下が考えられる。

• 事後評価セッションではなく中間地点なので、細かいタスクに目が向きがちだった。
• ホワイトボードがなかった。

アジェンダで中期的なプロセス改善につながる Try を挙げてもらうように、最初から行っておいた方が良さそうだ。

次回以降「ふりかえり」については工夫の余地あり。

今日のさえずり: 生まれて初めて10円券20枚を行使した

2010年12月20日

• 10:12 DropboxPortable って開発停止なのか。今の 0.7.110 の状態で使い続けるか迷うところ。 #Dropbox
• 11:07 週次グループミーティングのアジェンダに、いつも「その他」があるのが気になる。
• 12:09 生まれて初めて10円券20枚を行使した。 (@ 向日葵 和泉町店・カレー食堂) http://4sq.com/gmh7J4
• 12:16 「またいっぱい貯めてくださいね(ハート)」※注「ささやかな気持ちDESスクラッチ」は350円弁当にはつきません。
• 12:51 RT @tuiteru: これは楽だ。　nDiki: Gmail 無しの Google アカウントで Google Contact Manager が使えるようになった http://t.co/rLec9Rt via @Naney
• 13:22 まだ食後だけど、もう我慢ならなくてお土産にもらった萩の月を食す。
• 13:26 Subversion / CVS の時は何か面倒な気がしてまずブランチしなかったんだけれど、Git だとホイホイだなあ。
• 15:13 なんか「後で感想を聞きにくるコーヒー」をいただいた。
• 15:31 普通かな。香りはあまりしない。味はあまり苦くないマイルド系。 RT @Naney: なんか「後で感想を聞きにくるコーヒー」をいただいた。
• 19:27 charset を間違えたコミットメッセージの修正で git rebase -i しようとしてはまった。コマンド-ログ行の並びが上ほど古いのを逆と勘違い(メッセージが化けてたこともあって)。何度も違う方を修正しようとしてしまった。
• 21:13 モバツイ Who's Who!? http://bit.ly/gwqsEY
• 21:25 モバツイ Who's Who!? ってマイリストに登録する時にメモがつけられるんだ。Twitter に欲しいと思っていたのでいいかも。20文字はちょっと少なめかな。 http://bit.ly/gwqsEY
• 21:28 モバツイ Who's Who!? でもまだちょっと不安定。プロフィールも出たり出なかったりする。 http://bit.ly/gwqsEY
• 22:10 うちの会社のサイト、郵便番号が書いてないな。
• 22:37 LinkedIn ってどんなものかなと思って登録してみた。 http://linkd.in/f9Iri0
• 22:39 LinkedIn にも Like が。
• 22:41 @Keiichi_SHIGA 言語別にプロフィール作れるんですね。でも名姓順になるからちょっとイケてない。
• 23:38 about.me もアカウント作ってみた。 http://bit.ly/ggLun1

今日のさえずり: アルクーノって。駅近物件もあるのかな。

2011年11月16日

• 06:36 36.2℃ 予防接種いける。
• 08:37 RT @Yam_eye: 空気が透明なのは、そうなるように人が進化したから（空気を透過しやすい波長の光に人の目が適応した）というのを実感させてくれる朝。
• 08:56 そろそろいつでも使えるようにオイルヒーター出した。電気代の怖い季節きた。
• 09:16 そして今日からダウンジャケット。
• 10:23 前略プロフィールがもしクローズとなると、ユーザはどの SNS に流れるか。まあそれしかやっていないという人は少ないのだろうけど。
• 10:24 どっかに買ってもらうのかな。
• 10:26 SSID の末尾に _nomap とかダサい。
• 12:21 RT @shmorimo: 今日もHMZ-T1で仕事してる。仮想Desktopを導入したので解像度の低さはあまり気にならなくなった。おでこが痛くならないように緩めに装着してるので、じょじょにズレてきてピントが甘くなるのだけが欠点。なんとかしたいなぁ。
• 13:06 アルクーノって。駅近物件もあるのかな。 http://t.co/Eenb5dsT
• 13:36 野菜炒め定食 550円。 (@ 日高屋 渋谷宮下公園前店) http://t.co/zX89oAXm
• 13:59 エレベーターに乗ってた女の子の Android ロック解除ボタン一発で見切った。
• 14:09 株式会社三昧生活の方ですか? RT @pinstripe_: @Naney クローズのSNSで今、来てるのはみんつですね。http://t.co/Kby8Skxk
• 14:13 ヤク打ってくる。
• 14:23 インフルエンザ予防接種済み。針細いのか痛さほとんどなし。
• 14:33 ガチャピンの Tweet ことごとく 100RT over って。 @GachapinBlog
• 18:40 Google ドキュメントのスプレッドシートでのフォーム機能、「その他を選択したら自由記述テキストボックスが有効になって入力必須に」とかできた気がしたんだけれど、久しぶりに弄ってみたらぜんぜんそんなことなかった。何かと勘違いしてたのかな。
• 19:09 Alloy
• 20:01 今日の LT はドラボーイが不憫でした。
• 21:39 退勤。ビル出る時のドア、最近いつもピリッとする。
• 21:44 Perl でバックトラックで終わらない正規表現の例作ろうとしたんだけれど、良きにはからってくれてしまってあっさり終わってしまう。
• 23:07 クロネコIDよ、おまえも6文字以上なのか。
• 23:53 PlaceEngine も _nomap 追従か。
• 24:46 RT @yuzuemon: 今日の議事録「でも合コンって何話せばいいの？TPPの話とかダメでしょ」「今度アジェンダ送っておきます」

今日のさえずり: 前歩いてるサラリーマンの靴から画鋲の音が

2011年11月21日

• 06:26 本日、午前半休です。
• 08:25 手術日。 (@ 東京都済生会中央病院) http://t.co/RzanbCbp
• 10:18 ちい散歩で北参道がテーマ。原宿のあのビルもちらりと写ってた。
• 10:52 「ファクト・トーク」と「おしゃべり」
• 14:10 戻ってくる前に時間切れ。離脱。
• 14:41 パン他 365円。 (@ ローソン 渋谷2丁目店) http://t.co/siSEhPYL
• 17:51 手術予定通り終わったとのこと。
• 20:15 山手線止まったのか!? そろそろ帰ろうと思っていたのだが、アジェンダとか書くか。
• 20:17 山手線が止まったの今回は Twitter じゃなくて mixi で先に気がついた。
• 20:21 生ボイス。 RT @yaizawa: mixiボイスのTwitter連携だったら微妙ですが…どうなんでしょうw RT @Naney 山手線が止まったの今回は Twitter じゃなくて mixi で先に気がついた。
• 22:23 退勤。あれ、半休なのにもうすぐ8時間。
• 22:27 前歩いてるサラリーマンの靴から画鋲の音が。
• 23:34 家に帰ったら「掃除機のホースが裂けてた」との報告。保守部品で買えるのかな、これ。
• 23:56 ホースだけ売ってるけどサービスステーションに問い合わせる必要があるっぽい。

ミーティングの冒頭をボケてで始める

ミーティングのアジェンダに華がないので、ボケての画像貼っておいた。ウケた。

ミーティングの最初に「うまくいっていることを全員が話す」ことでイケル感じのムードをつくると良いというのは「すごい会議」で学んだ。ミーティングってけっこうムードに左右されるので重要。

みんなが自分で声を出してうまくいっていることを話すのが一番いいのだけれど、時間とか場の関係でそうもいかなかったりする。自分が進行でプロジェクタに PC をつないでいる時は、始まる前に今日の一押しボケてを表示しておいたりする。結構前からやっているのだけれど、場がゆるんで良い。

ゆーすけべー氏がトークの開始時間前にボケてを表示して、ゆるくつかみとっていたりしているのいいなと思って真似させていただいている。

今日のさえずり: ムーポーチ欲しいと思っていたけれど予約注文終了していた

2014年08月22日

• 08:23 hoge-moeshoku で .com ドメインが個別にいっぱいある! / “静岡もえしょくプロジェクト　富士山本部” http://bit.ly/1q3qvRV
• 10:35 LINE のパスワードをもっと長くした。
• 10:53 ミーティングのアジェンダに華がないので、ボケての画像貼った。
• 11:11 “【ボケ】アクサダイレクト : ボケて（bokete）” http://bit.ly/1ACKBqH
• 20:01 ムーポーチ欲しいと思っていたけれど予約注文終了していた。が6,660円(税別)なので、もともと買える世界ではなかった。
• 22:00 ヱヴァンゲリヲン新劇場版: 序 TV版やっているの今思い出した in the office。
• 22:32 ログイン失敗時に激しくリトライするツール作るのやめて欲しい。
• 23:00 タイムライン的に、家に着く直前に終わったぽい。

ミーティングアジェンダにアニメーション GIF 画像

「ミーティングのアジェンダに心霊写真みたいな動く何かが!」とおののいて、よくみたらアニメーション GIF だった。やるな。

— Naney (@Naney) September 30, 2014

「ミーティングの冒頭をボケてで始める」とかたまにやったりしているのだけれど、今日はアジェンダ開いたら Google ドキュメントの資料でネタ画像が動いていて、たまげた。発想面白くて良いと思う。つかみとしてはマルだけれど、ミーティング中に動き続けていると集中できないねという結論にはなった。

Google ドキュメントにアニメーション GIF 画像貼れるのね。

今日のさえずり: 人は死ぬほどフィードバックに飢えている

2014年09月30日

• 08:11 サードパーティ cookie ブロックしていると My docomo ログインできない。
• 08:19 NTTドコモの月々サポート適用額2,835円が2014年7月利用分が最後で利用料金が増えたし、タイプXi にねん + Xiパケ・ホーダイ フラットは追い出し施策が走っているし。
• 08:26 6月 770,181KB、7月 922,567KB、8月 1,012,580KB しか使ってなかった。大半 Wi-Fi 環境だし。
• 11:41 総アクセス数 : 5 http://mixi.jp/list_visitor.pl
• 11:47 2011年6月12日の時点で総アクセス数 184,352 だった。
• 15:03 “株式会社ノハナで最高の夏(インターン)を過ごしてきた - memo63” http://bit.ly/1rAzlbN
• 15:03 @anoworl おつかれさまでしたー。
• 15:14 「ミーティングのアジェンダに心霊写真みたいな動く何かが!」とおののいて、よくみたらアニメーション GIF だった。やるな。
• 18:09 @unk おつかれさまでした!
• 20:39 ドコッチ01のモック欲しい。
• 22:41 水痘に怯えている。
• 24:53 人は死ぬほどフィードバックに飢えている。もうソーシャルなサービスはそこ1点だけ攻めればいいと思う。

複数チームへの共有事項を1つのタイムライン型ページに書いてみる

各チームの週次定例ミーティングで共有したい共有事項をどう取りまとめておくのが良いかしばらく考えておりました。それぞれの週次定例ミーティングのアジェンダページに書くのは面倒なので避けたいところ。かといって週別の「今週の共有事項ページ」だとチームによって定例の曜日が違うので新着の共有漏れがおきてしまう感じです。

そうなると日付別にタイムラインとして並べておくのが一番な気がしてきました。各定例ミーティングの際に前回からの未読の部分を共有していくのが良いのかなと。いったん Qiita:Team に共有タイムラインページを作ってそこに書くようにしてみました。やはり日別最強かな。

マネージャーとしてのメンバとの信頼関係の構築

おとよ氏が記事「エンジニアからマネージャーになって変わったこと・変わらないこと」で「メンバとの信頼関係構築」と「役割が変化しても技術を学び続けること」が大切という2点について述べられている。

• エンジニアからマネージャーになって変わったこと・変わらないこと – mixi developers – Medium

おとよ氏は信頼関係構築のために

• 話を最後まで聞く
• 否定しない
• 人に興味を持つ

を大切している行動原則として挙げて実践されている。素晴らしい。まさに「人を動かす」を実行されてらっしゃる。

@swkn40 氏がこの記事を受けて「メンバとの信頼関係構築」の点について日記を書かれた。

このすんばらしいエントリを読んで、久々に日記書いた。

“エンジニアからマネージャーになって変わったこと・変わらないこと” by @otoyo0122 https://t.co/WNYVLM9aey

— swkn40 (@swkn40) 2018年10月11日

その中で言及していただき恐縮でござる。

私もまだまだ未熟で上の3点もできたりできなかったりだけれど、少しでも評価していただいているなら嬉しい限り。

意見の相違の時

@swakn40 氏がおっしゃっている通り、意見の相違があった時をどう振る舞えるかは大きなポイントだなと。自分、すぐ顔に出ちゃうので要注意(「私の話し方や態度についてどう思いますか?」)。相手への「尊敬・感謝」があれば全然問題にならないのでそこを意識したい。

雑談

人を動かすで言うところの相手に「誠実な関心を寄せる」が天性でできる人と、意識しないとできない人はいると思っていて、自分は後者寄り。意識してスイッチを入れる必要があるというのを受け入れていく必要がある。

one-on-one ミーティングの最初に「うまくいっていることを話す」というアジェンダをいれるのは、自分みたいな雑談力低めなタイプにはお勧め。

one-on-one ミーティングのノート形式

one-on-one ミーティングにあたっては相手と自分のみ閲覧・編集できるノート(アジェンダ)を用意している。

ここ数年は Google ドキュメントを使っていて、半期(半年)毎に1ドキュメント作成してそこに書くようにしている。そこに毎週(あるいは隔週)の one-on-one ミーティング前に日別の見出しを作って下に追記していっている(新しい日を上に追加していく方がスクロールせずに書き始められて楽なんだけれど見返す際に日付順の方が圧倒的に見やすい)。

今使っている形式は以下(表現上 Markdown 形式にしているけど、実際はGoogle ドキュメントのスタイルで)。

通算回数は「結構話し合っている!」感が出てくるので分かる人は書いておくようにしている。ミーティングの最初に「うまくいっていることを全員が話す」ことでイケル感じのムードをつくると良いというのは「すごい会議」で学んだ。

 # 2019年05月30日(木) (第n回)

 ## うまくいっていること
 - (相手の名前):
     - 前回: (前回のうまくいっていることを転記)
     - 今回:
 - (自分の名前):
     - 前回: (前回のうまくいっていることを転記)
     - 今回:

 ##  話したいこと・気になること

 ### (相手の名前)より

 ### (自分の名前)より

自分の方が話しすぎちゃっているかもという反省から「話したいこと・気になること」から人別のセクション消して自分の方の議題をあらかじめ書かない方がいいんじゃないかとちょっと思って今週ちょっと消してみたりした。

でも Google re:Work - ガイド: マネージャーにコーチングを指導するのサンプルテンプレートでもマネージャーとチームメンバーのセクションがあって、やっぱり問題ないかなって思えてきたので今まで通りにすることにした。ってことがあったので書いてみた感じ。

身近な人がやっている形式の記事

• 夢にでるほど1on1について考えた