わかりやすいドキュメントを効率的に作成したい

 一ヶ月程前に、ちらっと読んだ「WEB+DB PRESS Vol.25」に、ソフトウェア開発におけるドキュメント作成の記事が載っていました。あまり細かいところまでは読んでいないのですが、

「ドキュメント作成では、読み手が読みたいことだけを書くようにしないさい」

ということが言われていました。  となると、「クライアント向け」「開発者向け」と、ほとんど同じ内容のドキュメントを2倍作成する必要が出てくるわけですが、そんな効率の悪いことはしていられません。

 そこで、私が最近研究しているのが「レイヤー機能を利用し …

すべて同じことの言い換え

以下はすべて同じ意味の言葉の言い換えです。

・愛は究極の真理である ・愛の上に論理がある ・愛無くして、世界を説明することはできない

これらの言葉が、どういった意味かを説明する前に、算数の問題を一つ。

(問題)  「2*3=6」であることを説明しなさい。

(解答例)  2*3は、2を3回足すことなので、2+2+2の答えと等しい。  2+2+2=6なので、2*3=6となる。

この問題では、「掛け算」を「足し算」によって説明しました。 さて、では次に、「2+2+2=6」であることを説明して下さい。

・・・・・、 …

合理主義者であり、ロマンチストであり

数年前に行われた、大学時代の先輩と僕の会話。

先輩:「おまえは合理主義者であるにも関わらず、ロマンチストである点が理解できない」 僕:「愛は究極の真理だからです」 - 先輩が、握手を求める。 僕:「どうして握手を求めるのですか?」 先輩:「俺と同じだからだ」

そんな先輩であり、そんな僕なのです。 この短い会話で、僕たちがどれだけのことを理解し合えたのかはわからない。けど多分、お互いに伝えたかったことはちゃんとわかっていると思う。

ところで学問の目指すところは、「究極の真理の探求」。 僕(と先輩)の考え方で …

ふと思い出したeXtremeMeeting

議事録を書いていてふと思い出した、XM(eXtreme Meeting)。 →http://extrememeeting.org/

「議事録ドリブンの会議」ということなのだが、要は

ねらい:  ・会議の生産性を向上させる

取り組み:  ・目的をはっきりさせた上で会議を行う  ・議事録というアウトプットをきちんと残す

と、いうこと。

XMほどまでやるかどうかは別として、出席者に議題すら通知されていないような会議って多いよね。

何のために、その会議をやるのか? 会議だけではなく、何かに取り組む時に、その取り組み …

オープンソースのトレンドを追いかけて

 皆さんは、オープンソースのソフトウェアをどこで知りますか?  私はオープンソースのソフトウェアの情報源の一つとして、時々次のブログを見ています。  → http://www.openalexandria.com/

 このブログは、オープンソースのソフトウェア(ビジネス系だけでなくマルチメディアやゲームなども含む)を毎日一つずつ紹介しています。  毎日このブログを見ていても、なかなか有望なソフトウェアはみつからないのですが、ちょっとした宝探しの気分で覗いてみてはいかがでしょうか?

 ちなみに最近興味を持った …

成果主義の成果についてひとりごと

成果主義の「成果」とは何でしょうか?

まず、会社の「成果」を考えてみると、どの企業でも、普通は「公共の福祉の増進」を目指します。

具体例をあげると、 トヨタ自動車:『自動車をとおして豊かな社会づくり』をめざすこと ホンダ:『世界中の人々に「喜び」を提供するため』にチャレンジすること 松下電器:『生産・販売活動を通じて社会生活の改善と向上を図り、世界文化の進展に寄与すること』 NEC:『人々や社会の新たな可能性実現に貢献』すること 新日本製鉄:『鉄事業を中核として、豊かな価値の創造・提供を通じ、産業の発展と人 …

@type市場価値診断テスト

 「@type」で市場価値診断テストなるものを受けてみた。

 簡単な質問に「はい」「どちらでもない」「いいえ」で回答していく。最後には、ビジネスのコアスキル・性格特性の診断結果を出してくれる。  その結果によると、私は「守り型のリーダータイプ」で、『守り向きのタイプと言え、きめの細かな管理ができるコーディネート能力に優れたリーダー』だということらしい。その他の細かな結果で、コアスキルを見てみると、ビジョン・マネジメント・情報収集などの能力には優れているが、プレゼン・異文化適応は劣っている。性格特性は、論理 …

プロジェクトマネジメントの資格

プロジェクト・マネジメントの資格について、以下に簡単にまとめました。 受験資格や実施回数から考えると、英語が苦でなければ、「Comptia Project+」が受験しやすそうですね。

  1. PMP  汎用系PM、国際試験  http://www.pmi-tokyo.org/02/000200.html  受験料:555$  ※実務経験及び教育受講が必要、試験は随時  教育受講の教材例:http://www.seshop.com/detail.asp?pid=4829

  2. 情報処理技術者試験、プロジェクトマネー …

「PMP試験対策講座1基礎編」受講ノート

ここでは、「Project Management Professional試験対策講座1 基礎編 PMBOK概要」を受講した感想をまとめています。

■教材の紹介  まずはじめに、教材の概要を紹介します。

・PMP(Project Mangement Professional)試験対策用のeラーニング教材 ・PMBOK(Project Management Body of Knowledge)の概要の解説 ・教材は、講義ビデオと講義用プレゼン資料で構成されている ・講義用プレゼン資料はPDF形式でも用意されて …

北区内田康夫ミステリー文学賞

北区内田康夫ミステリー文学賞なるものがある。

この作品の大賞作品が、3月15日発売のJ-novelに掲載されたというので早速、買ってきて読んでみた。

内田康夫氏と言えば、浅見光彦ミステリーシリーズが有名なので、受賞作は、きっと殺人とかのあるミステリーなのだろうな、と勝手に思いこんでいたのだが、

大賞の「ドリーム・アレイの錬金術師」は、王子(東京都北区)を舞台にしたほんわかとした感じの小説だった

ところで、ミステリーというジャンルの定義って? 私も自分のホームページで公開している小説を、ジャンル分けするのに困 …

最近のお笑いはシュールですか?

しばらく前からお笑いブームなんだけど、 お笑いって年々シュールになってるなって感じがする。 ところで、シュールって言葉、結構みんなわからずに使っているみたい。

シュールレアリスムって、もともと、英国の産業革命の時代にできた言葉で、 工場の煙突から吹き上がる黒煙、車のどす黒い排気ガスといったような 常識の感覚で汚いものを、美しいと表現したことから始まった。 つまり、従来の一般的な感覚とは異なる感覚のことをシュールと表現する。

ということで、シュールなお笑いの意味を定義すると、以下のようになる。 「従来の一般的 …

東京都北区物語

 泉麻人著「新・東京23区物語」(新潮文庫)という東京23区を区ごとに紹介した書籍を読んでみたのですが、区に応じて随分と紹介する内容を分量に差がありました。紹介されている分量を多い順に並べてみると(括弧内はページ数)、港(21)、渋谷(21)、中央(19)、世田谷(17)、千代田(15)、新宿(15)、台東(11)、中野(11)、豊島(11)、文京(9)、墨田(9)、杉並(9)、練馬(9)、葛飾(9)、江東(7)、品川(7)、目黒(7)、大田(7)、板橋(7)、荒川(7)、足立(7)、江戸川(7)、北(5) …

情報共有と力関係

最近、自己啓発などに役立つ情報を交換し合いましょうということで、身近な知り合いとメーリングリストを作りました。メーリングリストのメンバは、私の会社の同僚と関連会社の人で年齢が近い人ばかりで。今のところ5名。

 私の会社では技術情報の交換のためと称して、しばしばメーリングリストを立ち上げて来てはいましたが、活発に議論が行われていたとは言えない状況でした。よくあるパターンが、ちょっと職位の上の人から「用語を正しく使え」とか「ぐだぐだ言っていても仕方ないだろ」というようなメールが飛んできてメールがぱたりと途絶えて …

開発支援ツール:WebScan

ここでは、Webブラウザでの表示イメージをコピーして他のAPに貼り付けを行うことができる「WebScan」を紹介します。

WebScan

ソフトウェア情報

概要:
 Webブラウザでの表示イメージをコピーして他のAPに貼り付けを行うことができるツール。
役立つ時:
 WebAPの仕様書・マニュアル作成で画面イメージを取得する時
ポイント
 ・画面に収まらないような縦長のページを一括でコピーできること
 ・イメージの拡大縮小ができること
配布先URL:

WebScan
縦に長いWebページもボタン一つで一発キャ …

開発支援ツール:InetSpyと横取り丸

ここでは、Webブラウザからのリクエスト及びサーバからのレスポンスの通信内容を参照するツールの「InetSpy」を紹介します。
※InetSpyの動作には「横取り丸」が必要です。

InetSpyと横取り丸

ソフトウェア情報

概要:
 Webブラウザからのリクエスト及びサーバからのレスポンスの通信内容を参照するツール
役立つ時:
 Webアプリケーションのデバッグ時、HTTPの通信に絡む問題を調査する時
ポイント:
 Webブラウザとサーバ間の通信内容を参照できる、特にリクエスト・レスポンスヘッダを確認できる …

Author
takemikami
データエンジニア
・データ分析基盤の開発運用
・マーケティングデータ分析
研究履歴 / 執筆履歴 / プロダクト
facebook
X(twitter)
BlueSky
Instagram
LinkedIn
Hatena::Bookmark
YouTube
GitHub
SpeakerDeck
slideshare
GoogleScholar
ブクログ
Books
takemikami's shop
Recent Posts
    [PR]
    PlayStation
    Steam
    About