Home > Archives > 2009-08

2009-08

[blog] なんか表示が遅かったんで・・・。

Pocket

今まで普通にアクセスできていたが、すぐに表示されていない現象に見舞われ、なにが原因なのか?っていうのをちょっと検索してみたところ
TwitThis
が原因でした。

アイコンが表示されていなかったので、すぐにわかったんですが、トラフィックも結構負荷かけていたのかもしれません。

今は一時的にプラグイン停止しております。
まぁ悲しいことに特につぶやいてる人いないので、これはもう使わないかも?w

From xxxYukihiroxxx

Pocket

[reproof] わかりやすい技術文章の書き方について俺なりに・・・。

Pocket

わかりやすい技術文章の書き方

数日前から気になっていたページの一つ。
ちょっと自分の考えを述べてみようかと。

このページは、プログラムやコードなどの主に技術文書を書く方々のために、分かりやすい文章を書くためにはどうすればよいのかについて説明しています。

1.自分が伝えたいこと・訴えたいことを誤解しないように相手に読んでもらうにはどうするべきか。
2.文章を書くにあたって知っておくべきルールは何か。
3.文章を書く前にどのような手順を踏めば、分かりやすい文章を作れるか。

などについて参考にしていただければ幸いです。

実はこれ、プログラムやコードなどの主に技術文書を書く方々に向けておりますが、ものつくりにも当てはまります。
建築でいえば、設計図、図面など。

ここのブログを見ている方は、恐らくWeb関係が多いのでは?
ということで、ピックアップすると、ファイル名などの命名規則サイトマップ(階層の整理)、CSSなどの詳細設計書、W3Cに引っ掛かってもこれは問題ないといける参考文献をまとめること。
チェックリストデバックリスト画面変移図、DBを使っているならばデータベース詳細項目(intなのかcharなのか16進とか)などなど。
単体検証全体検証パターンリスト最終確認完了しましたよの書類。(ここまで来ると過去の仕事内容が思い浮かびます。w)

クライアント様からそこまでは要求はされないはずですが、大きなプロジェクトになればなるほど、設計始める前にこのような基本的な情報を制作者たちに教える必要があるんです。これが標準化されればもっと嬉しいことなのですが、そんな時間ないよ。ということで、作ったら作ったで終わり。次の仕事。ってなる。

顧客からのクレーム対応マニュアルがあるところはたいてい、プロジェクト進める前の準備(標準化)はされているはず。w

で、あんたは今まで納品した仕事で説明書とか作ったの?という質問がきそうだが、実際に作ってました。
しかも、自分から手が離れてからはしばらく安定するまではサポートしますが、基本的にはドキュメントにすべて書いてあります。
相手が、Webの知識がない人でもわかるような資料です。

一番手っ取り早いというか、これは間違いようがないというのは
画面のキャプチャーを添えた説明書みたいなもの。

みなさん、見ているはずです。
電気機器を購入して付いてきた説明書
分厚くて読まずに捨ててしまう説明書

あれを参考にすれば技術文書なんてつまずくことなく、書けます。ほんとに。

日本語から英語にするというのは、至難の業になりますが、技術屋としては避けられない道です。

過去の事例とかは詳細というか、どの部分を担当したか?キャプチャー、日数とかは明確にされているが、中身は?となると、???になってしまう。
あー、これ担当した人はもういないからなぁ。。。
(Web業界では人の流れも速いみたいってこの業界に足つっこんでみて実感しました。)

それじゃー、意味ないんです。

あと、安さを求めて海外に発注する方もいらっしゃるのでは?
どこをどうすればどうなるのか?というのもドキュメントとして残す必要もあるということです。

「ソース見ればいいじゃない。」

それでいいんです。けど、設計書があれば、もっと時間短縮できて効率のいい仕事ができると思います。

ここをこうした理由はこういうことになってしまうから。By hogehoge
この一言でもぜんぜん違うんです。
「え?なんで?」と思ったら自分で考えてみて、それでも趣旨が伝わらなかったら聞けばいい。

本当にread_meだけでどれだけ助かることか。。。

フリーソフトの場合、必ずreadme.txtが入っています。もしくは、URLのリンク先。
どう使えばいいのかわからなくなった場合とか、どのexeファイルが起動用なのか?など、簡単な説明書。

このreadme.txtも意味があって、copyrightみたいな感じでもあります。

自分の場合、ほとんどのソース(phpなどのプログラム関係)はヘッダーに自分のサイン、変更履歴を残すようにしています。あと、バージョン管理!
あー!バージョン管理!かなり重要です。

なんか余談になってしまいましたが、まずはお手元にある電気機器の説明書を仕方なくペラペラと見てください。
2種類あればかなり比較できるかも?
説明書なんてねぇ!という方は、次買いたい電気機器のオフィシャルホームページに行っていただき、発売前だったら新製品になる前の型の説明書をダウンロードしてみてください。(PDFファイルで用意されています。)

こっちはこういう順番なのに、こっちはどうして?とかいろいろと違いが見えてくると思います。

参考文献を見るのもいいですが、身近なものから得た方がかなり親近感沸くと思います。

だって、第3者でもわかる説明をしているのだから

From xxxYukihiroxxx

P.S
設計より検証する時間の方が時間がかかります(チェックリストがあればあるほど)。
つまり、設計時間<<<<<検証時間となります。
設計時間=検証時間になる方法がある場合、技術屋さんに教えてくださいませんか?

Pocket

[Thinking] オタクになれるかどうか?

Pocket

立派なタイトルだ。w

これかなり重要で、仕事からも趣味からもなんでも適応できると思ってます。

というのは、”狭く深く”という考え方と、”広く浅く”という考え方の2通りがあります。
いや、”広く深く”の3通りかもしれません。いやいやいや、”狭く浅く”でいいんじゃね?ということで4通りです。

オタクってその分野に関してはずば抜けて知識があり、しかもFANでもある。

「あなたにはオタク要素ありますか?」というThinkingTimeです。

なんでもいいんですよ。
市販されている水のきき水、きき酒などの味系、ヘッドランプ見ればわかるとかの物系、あの花の種類がわかるとか、キノコの種類などの植物系、カブトムシの種類などの動物系、PC系もありますし、アニメ系もあります。花火系とか、本当になんでもいいんです。

「これはすごいんだぞ!」と言える分野がひとつでもあれば、その熱い情熱(別に好きだから知識が豊富になっているんだよな。って思った方はその好きの気持ちを持ち続けるべきです)をなくさないでください。

それが仕事に生かせるかどうかは別の話ですが、仕事にも役に立つような知識だったら最高ですよね?

自分の場合は、なんだろう?
カメラかなぁ?んー車?水か?機械関係か?正直、自分自身わかってないです。これが”浅く広く”の人の答えだと思います。

情報収集とか、計画立てるとか、そういうのは完璧なんですけど、これはオタクにはならないっぽい。w
ただの情報まとめるのがうまいひとにすぎない。

初めて行く旅行先の案内など道や距離、その速度でいけば、何分で到着するか?どこをどの時間だけ見学して、次の到着地点の住所はどこか?など、あらゆることすべてを網羅して、計画表通りに進める。その時、ちょっとここは時間かけてみたい。となった場合、時間と距離を考慮して、経由地点を変えたり、削除したりなどなど。
これちょっとした自慢話(大学の時のお金がない時だったので、時間と宿泊地とか結構大変だったので念入りに予定立てたら計画通りに進んだ1週間。マジで驚きました。)です。w

From xxxYukihiroxxx

P.S
ゼッタイ”はありません。本当に。
ゼッタイダイジョウブデス。と言ってきた人に対して「どういう理由(根拠)で?」と問いてあげましょう。相手はちょっと考えるか、即答するかでその人の何かに気がつくはずです。
れっつとらい!

Pocket

[seriku] 100mの世界新記録について

  • 2009-08-17 (月)
  • Diary
  • 作成者:xxxYukihiroxxx
Pocket

100mを9秒58で駆け抜けて優勝したウサイン・ボルト選手。どんだけスピード出てるんだということで、計算してみました。時速で、37.578km/hでした。
現役で陸上競技をやっていたころ、50mで5.9秒を自己マークしたことがあって、それでも、ぜんぜん追いつきません。

単純にいえば、10mを1秒もかからないんです。
実感湧きませんよね?

過去の歴代記録は以下の通り。

9秒58
風向き+0.9 ウサイン・ボルト ジャマイカ 2009年8月16日

9秒71
風向き+0.9 タイソン・ゲイ アメリカ合衆国 2009年8月16日

9秒72
風向き+0.2 アサファ・パウエル ジャマイカ 2008年9月2日

9秒79
風向き+0.1 モーリス・グリーン アメリカ合衆国 1999年6月16日

9秒84
風向き+0.7 ドノバン・ベイリー カナダ 1996年7月29日
風向き+0.2 ブルニー・スリン カナダ 1999年8月22日

9秒85
風向き+1.2 リロイ・バレル アメリカ合衆国 1994年7月6日
風向き+0.6 ジャスティン・ガトリン アメリカ合衆国 2004年8月22日
風向き+1.7 オルソジ・ファスバ ナイジェリア 2006年5月12日

9秒86
風向き+1.2 カール・ルイス アメリカ合衆国 1991年8月25日
風向き-0.4 フランク・フレデリクス ナミビア 1996年7月3日
風向き+1.8 アト・ボルドン トリニダード・トバゴ 1998年4月19日
風向き+0.6 フランシス・オビクウェル ポルトガル 2004年8月22日

2008年9月2日に9秒72で記録されたアサファ・パウエルが今回、9秒58で0.14秒も記録更新された。しかも、1年の間で。

しかも、ウサイン・ボルトは最後10m前で左をチラリ、いや、5mぐらいから流した感じがした。
4年後に楽しみを望んでいるのか?それとも、次の大会で出すのか?

彼はまだ22歳。

100mの記録はもしかしたら、9.4秒台ができるかもしれない。。。

新記録は夢だが、薬だけはやめてもらいたいと切実に思う今日この頃でした。

From xxxYukihiroxxx

Pocket

[iphone] アプリでも作る前に考えてみようか? [アプリ開発]

Pocket

まぁ~どうでもいいのが作ってみたいというのが頭をよぎったので、ちょっと考えてみようかと。

だいたい他の開発者たちがほとんどのアプリをリリースしているので、本当に必要ないものを作ってみようかと。

DB連動で、iPhone内蔵のGPS機能を利用して、現在地の周辺にある○○を探せる。目的地を指定して、○○を見つけることを可能にしてみようかと。
あと、評価なども☆で見えるようにしたいし、詳細情報も入れたいし、予約管理まではしない。すべての情報をかき集めるまで結構時間がかかってしまうこと間違いなし。

自分の時間を見つけては、ちょっといろいろと探索したいと思ってます。

情報提供とかあればもっと嬉しいが、本格的になったら、再度告知します。

アイコンのデザインをかっこよくというか、シンプルにしたいと思う。
で、あきらからにそれか?というのも嫌なんで、ちょっとひねった感じで。

個人的な趣味なので、不完全になってしまう可能性もあるかもしれないが、なるべくリリースしたいと思ってます。
あーこれが出来たら、本当にうれしいかも。

From xxxYukihiroxxx

Pocket

Home > Archives > 2009-08

Search
Feeds

Return to page top