Writers and Developers: The Dynamic Duo (2)執筆者と開発者:ダイナミックな2人組
When writers wore an editor’s hat, we helped fix the symptom, not the cause執筆者が編集者の帽子をかぶっていたとき、我々は、その原因ではなく、症状を直す手助けをしましたA few releases ago, our team of tech writers performed the role of a release note editors. We collated all the bugs written by our developers, made some grammar edits, turned it into a crisp summary, and added it to our release notes. Most of the time, the bug description required more than just a grammar edit. To rewrite the bug, we had to dig deep into the issue, read the underlying descriptions or inline comments, or reproduce the steps to write a simple one-line summary. We often found ourselves commenting, “need more information.” We spent more time than needed on each of the bugs as the bug title had too little detail written in plain English. Commenting in the bug tracking tool, asking for more information, with back and forth editing was not a scalable solution. Donning an editor’s hat seemed to be a downstream approach as we tried to fix the symptom and not the cause.2-3の公開前に、テクニカルライターの我々のチームは、リリースノート編集者の役割も果たしました。我々は我々の開発者によって書かれたすべてのバグを校合して、若干の文法編集をして、それを明解な要約に変えて、我々のリリースノートにそれを加えました。ほとんどいつも、バグの記述は単なる文法編集よりいっそう多く必要としました。バグを書き直すために、我々はその課題を深堀するか、基礎をなしている記述、あるいはインラインコメントを読むか、あるいは単純な1行の要約を書くために複数のステップを再現しなければなりませんでした。我々はしばしば「もっと多くの情報を必要とする」と、我々自身がコメントしているのを見いだしました。バグ名称が平易な英語で書かれた詳細をあまりにわずかしか持っていなかったので、我々はバグのそれぞれに必要とされるより多くの時間を費やしました。あちこちの編集で、バグ追跡ツールでコメントすることや、もっと多くの情報を求めるのは拡張可能なソリューションではありませんでした。編集者の帽子をかぶることは、我々がその原因ではなく、症状を直そうとしたから、下流からのアプローチであるように思われました。Data-Driven decision makingデータ駆動型意志決定When we tracked the actual time spent editing and rewriting the bugs created by ourdevelopers, on average we found that close to 60% of the bugs required a complete rewrite. These bugs required in-depth editing and research. On average, each release, a release note writer spent close to 6 hours working on these bugs. The need to optimize resources is evident when the organization’s demands exceed the resources currently available – we simply did not have the time.我々が我々の開発者によって作成されたバグを編集や、書き直しに費やされた実際の時間を追跡したとき、平均して我々は、バグのほぼ60%が完全な書き換えを必要としたことに気付きました。これらのバグは徹底的な編集と研究を必要としました。平均値、それぞれの公開で、リリースノート執筆者これらのバグに取り組んでほぼ6時間を費やしました。組織の需要が現在利用可能なリソースを超えるとき、リソースを最適化する必要があるのは明白です-我々は単純に時間がありませんでした。 ================================================インターネット・コンピュータランキング================================================ネットサービスランキング================================================ クーポン利用で1680円!\大人気ブロガーAYAさん◆コラボ新色発売!/ 楽天総合1位 プリーツパンツ 春夏 セルフカット レディース 13色 プリーツ パンツ ワイドパンツ 春 夏 シフォン 大きいサイズ 裾カットOK ウエストゴム リラックスパンツ ボトムス メール便可//10//価格:2980円(税込、送料無料) (2021/3/9時点)楽天で購入【CONVERSE】コンバース CANVAS ALL STAR COLORS HI キャンバスオールスターカラーズHI メンズ レディース 正規品 ロゴ 白 ホワイト ベージュ シューズ 靴 ハイカット価格:7150円(税込、送料別) (2021/3/9時点)楽天で購入【CONVERSE】コンバース ALL STAR US COLORS OX オールスター US カラーズ OX 限定カラー 正規品 ブランド シューズ 靴 ローカット価格:7700円(税込、送料別) (2021/3/9時点)楽天で購入モトローラMotorola moto g PRO 4GB/128GB ミスティックインディゴ simフリースマートフォン【おひとり様1台限り】価格:35800円(税込、送料無料) (2021/3/9時点)楽天で購入【クーポンで半額1,390円】洗顔料 洗顔フォーム 洗顔石けん ランキング1位 せっけん 石けん 石鹸 クレイ 泡 毛穴ケア パック しっとり 炭酸 オレンジ ラベンダー レディース メンズ 楽天スーパーSALE [プリュ(PLuS)カーボニック クリーニング パック (150g)] [通]価格:2780円(税込、送料別) (2021/3/9時点)楽天で購入