Documenting Faster to the Future 未来に向かってより速い文書化

Documenting Faster to the Future
未来に向かってより速い文書化

Rohini Garde, VMware
August 15, 2020
VMware社、ローニガルデ著
２０２０年８月１５日
In a recent company All-Hands meeting, VMware CEO, Pat Gelsinger, said, “Let’s move VMware faster to the future.” The phrase “faster to the future” got my immediate attention.
最近の会社のすべての手ミーテイングで、VMwareＣＥＯ、パット・ゲルシンガーが「VMwareをより速く未来に向かって動かしましょう。」と、言いました。 「未来に向かってより速い」というフレーズは私の注意を即刻得ました。
After the meeting, I started thinking about the phrase and wondered, “As a technical writer, what can I do to support this company goal? What could be my contribution in helping VMware move faster to the future? Can I document faster to the future”?
ミーティングの後に、私がそのフレーズについて考え始めて、そして、「テクニカルライターとして、私はこの会社の目標を支持するために何をすることができるか？ 未来に向かってVMwareがより速く動くのに役立つことにおいてどんな貢献をできるだろうか？ 未来に向かって私がより速く文書化できるのか？」と不審に思いました。
Well, as a technical writer for around 15 years, I always documented products after looking at the product, using, and testing the features myself. I always like to find out how each feature works, what might fail, or how to verify that the configuration worked. All the first-hand testing helped me write more accurate technical content.
まあ、テクニカルライターとしておよそ１５年間、私は、私自身で機能を使って、テストして、製品を見た後で、常にその製品の文書化をしました。私は常にそれぞれの機能がどのように働くか、何が失敗するだろうか、あるいは構成定義がうまくいったことを確かめる方法を見つけだすことが好きです。すべての直接の試験は私がいっそう正確な技術的内容を書く助けとなりました。
But in this typical documentation development process, understanding a feature requires waiting for others to complete their work first. To begin actual documentation about the product or a feature, development must first be code complete. So, my actual documentation development starts late in the Software Development Life Cycle. I had to squeeze in my tasks near the end of the development life cycle and scramble to test the feature, write accurate technical content, and get the documentation reviews done before the GA date.
けれどもこの典型的な文書開発過程で、機能を理解することは他の人たちが最初に彼らの仕事を完了するのを待つ必要がります。製品あるいは機能について実際の文書化を始めるために、開発は最初にコードが完全でなければなりません。 それで、私の実際の文書開発はソフトウェア開発ライフサイクルの後半に始まります。 私は開発ライフサイクルの終り近くで私の仕事を詰め込んで、そして急いで機能をテストして、正確な技術コンテンツを書いて、そしてＧＡ日付前に、文書レビューをするようにしなければならなかった。