私がDITAと分業を私の専門家に売りこんだ方法

How I Sold DITA and Division of Labour to my Subject Matter Experts
私がDITAと分業を私の専門家に売りこんだ方法
Niels Grundtvig Nielsen, Worldline
ワールドライン社、ニールス・グルントビ・ニールセン著
A lone technical author in a large company has to be persuasive, wily and diplomatic … or weep quietly in a corner as colleagues who’ve not actually been taught how to use a word-processor deliver almost unusable information. Well, that’s my take on it! though to be fair I was OFF to a good start here: during my interview with the then departmental manager and the technical author, it turned out they were already trying to introduce DITA-structured documentation. Also, most of my documentation tasks involve working with developers who are already familiar with the concept of re-use even if they’re astonished to discover you can apply the concept to text as well as code.
大企業の孤独な技術著者は説得力があり、ずるく、外交的でなければならない。…さもないと、実際にワードプロセッサーの使い方を教えられなかった同僚がほとんど利用できない情報を届けるから、片隅で静かに泣かなければなりません。 まあ、それは私の気持ちの吐露です! けれども公正に言うとここでは、良いスタートを始めていました:その時の部門のマネージャーと技術著者との私のインタビューの間に、彼らがすでに DITA 構造のドキュメンテーションを導入しようとしていたということが分かりました。 同じく、私のドキュメンテーションの仕事の大部分は、たとえ彼らがあなたがそのコンセプトを、コードと同様、テキストに適用することができることを見いだして驚いているとしても、すでに再利用のコンセプトに精通しているデベロッパーと働くことを必然的に必要とします。


I started off by migrating some older documents, which was also a good moment for tidying up some of the content: a pre-emptive strike, if you like, that could also be sold as pro-active and show the document owners a technical author is more than just a typist with a spell-checker. After enjoyable discussions with individual colleagues, explaining to them how their content had been transformed and why, the time came where I was ready to give an in-house presentation. The rest of this article is based on that presentation, to give you an idea of how one author in one context negotiated the move to a new way of working. YMMD, but I wish you every success!
私は、若干のもっと古い文書を移行させることから始めました。それはまた、内容のいくらかをきちんとすることに対して、良い瞬間でした。: 先制攻撃で、もし望むなら、それは同じく先を見越して売られて、そしてドキュメント所有者に技術著者がスペリングチェック付きの単なるタイピスト以上であるということを示すことができました。 個々の同僚との楽しい議論の後に、彼らに彼らの内容がどのように(すでに)変えられているか、そしてなぜか説明して、時は私が企業内のプレゼンテーションを行なう準備ができているところに来ました。 この記事の残りは、そのプレゼンテーションに基づいて、あなたに1つの状況での1人の著者がどのように新しい働き方への移行を交渉したかのアイデアを与えることです。 YMMD 、しかし私はあなたのためにすべての成功を祈ります!

ここから先は

10,514字 / 1ファイル

¥ 100

この記事が気に入ったらサポートをしてみませんか?