情報開発と利活用

令和維新

2004年4月から企業を離れ、コンサルタントや情報起業を試行しながら、失われた２０年を取り戻し、日本再生をめざす私の歩みをみて一人でも多くの後継者が出てくれることを祈りつつ友達から紹介されたこのホームページの更新を続け、これまでの活動の記録と今やビッグデータ、AI,、IOT,ブロックチェーン、仮想通貨の時代になってしまいましたが、私の現状認識と関連技術を紹介していきたい。

フォローする

UX

(0)

オンライン

(0)

ソーシャルメデイア

(0)

開発

(0)

スマートマネー

(0)

流動性

(0)

教育訓練開発手法の紹介

Headline News

Shopping List

お買いものレビューがまだ書かれていません。

< 新しい記事

新着記事一覧(全7180件)

過去の記事 >

2021.06.24

(7)How I Sold DITA and Division of Labour to my Subject Matter Experts DITAと作業部門を私の専門家にどのように売りこんだか

テーマ：英語のお勉強日記(8215)

カテゴリ：情報開発

Real-life examples ： what I show is what you get
現実の例：私が示すものは、あなたが手に入れるもの

The second half of the presentation was based on examples, screenshots of a concept topic, a task topic and a reference topic both in the IDE and in one of the possible output formats, plus a word about dita map containers. Of course, this was also the moment to show them the same source files could be deliver A4 .pdf and Web help: they liked that! And to mention that the developer team who package the Web help into the customer deliverable have helped me store the source files in a git repository – as soon as I commit agreed changes, this triggers generation of an updated Help set.
プレゼンテーションの後半は、いくつかの例や、 IDE と可能な出力形式の１つの両方で、コンセプトトピック、タスクトピックやリファレンストピックのスクリーンショットや DITA マップコンテナーについての単語に基づいていました。もちろん、これは、また、同じソースファイルが A4.pdf と Web ヘルプを配信することを彼らに見せる瞬間でした：彼らはそれを好みました！そして顧客提出物の中に Web ヘルプをパッケージする開発チームが、ソースファイルを git リポジトリに私が蓄積するのを手伝ったと述べるため－私が承認された変更にコミットするとすぐに、これは最新のヘルプセットの更新を引き起こします。

Better documentation from teamwork
チームワークでより良いドキュメンテーション

So now I’m working with colleagues who understand about reuse and structure! as a bonus, they are also adopting effective commenting now they get .pdf files to review. No-one had ever explained to them that (for instance) you don’t need to use one tool to draw a strike-through line and then another tool to show the text you want to add instead. The documentation review and update process is generally that bit tighter than it used to be, and being able to focus on bite-sized topics saves the developers time and effort they can now use on … development.
それで今私はボーナスとして、再利用や構造について理解する同僚と働いていますが、彼らは、レビューのため .pdf ファイルを入手し、同じく効果的なコメントすることを採用しています。彼らに（例えば）あなたが削除の直線を引く一つのツールや次にあなたがその代わりに加えることを望むテキストを示すためのツールを使う必要がないと誰も今まで、説明していませんでした。ドキュメンテーション見直しと更新プロセスはそれが以前そうであったより一般に少しもっと厳しく、そして細切れサイズのトピックに焦点を合わせることが可能であることは彼らが今 … 開発で使うことができる開発者の時間と手間を削減します。

That’s where the division of labour from the title comes in. As for DITA, colleagues now understand why I say:
それはタイトルからの分業が入ってくるところです。 DITA については、同僚は今私がなぜ次のことを言うか理解します：

· Lots of people I’ve spoken to about structured documentation are afraid of it.
私が構造化されたドキュメンテーションについて話をしてきた多くの人々がそれを恐れます。

· They think it’s a strait-jacket, a limitation.
彼らはそれが拘束服、制約であると思います。

· This just isn’t true. It’s a powered exoskeleton, helping you get more done
これはまさに本当ではありません。それは、あなたがもっとやれる助けとなる、動力付き外骨格です。

インターネット・コンピュータランキング
========================
ネットサービスランキング
========================