高木浩光＠自宅の日記 - 駄目な技術文書の見分け方 その1
■ 駄目な技術文書の見分け方 その1 はてなブックマークのホッテントリを見ていたところ、300を超えるユーザに登録された以下の記事があった。 今夜分かるSQLインジェクション対策, 上野宣, @IT, 2006年11月2日 また上野宣か。顔見知りなのでズバリいくことにする。 しかし、その対策はまだ本当に理解されていないように思える。 へえ。 終わりの方を見てみると、 Webアプリケーションの対策 入力値のSQLの特殊文字を適切にエスケープ 入力値＝プログラム（プロセス）に外部から入ってくるもの シフトJISの場合には1バイト文字を整理 SQLの記述をなくすためにO/R（Object/Relational）マッピングを活用 攻撃者に役立つ情報を与えないために、不要なエラーメッセージ（データベースが出力するエラーなど）の表示を抑止 対策に「準備された文」(prepared statement)
文章を書く心がけ
目次 はじめに 読者に対する心がけ 誰がその文章を読むのかを考えよう 読者は何を知っているかを考えよう 読者がどんな感じを受けるかを考えよう 読者と対話する気持ちになろう 自分に対する心がけ 書こうとせず、読もうとしよう 読もうとせず、読みはじめようとしよう 何でも書いていいんだよ 惜しげなく人に与えよう 人からのものには敬意を払おう 魔法の呪文は毎回発見しよう まず自分がよく理解しよう 知識を誇るために書くのをやめよう その他の心がけ 言葉についての心がけ 長い文は注意して使おう 書いたものは必ず読み直そう 適切な例を示そう 言い換えの練習をしよう ８割でよしとしよう すべてを動員しよう その他の心がけ 環境についての心がけ 人の「気」を意識しよう 頑丈で軽い文章作成のツールを使おう その他の心がけ 編集者に対する心がけ 助言はよく聞こう 自分の状況を正しく伝えよう 感謝の気持ちを忘れな
「文書を作ることができない症候群」 / 平林 純@「hirax.net」の科学と技術と男と女／Ｔｅｃｈ総研
奥村先生のブログで「少なくともこのページは読むべき」と紹介されていた「Ask E.T.: PowerPoint Does Rocket Science--and Better Techniques for Technical Reports」という記事を読みました。 スペースシャトル・コロンビア号は、打ち上げ時に剥落した液体燃料タンクの断熱材により翼部分が破損したことで、帰還中に空中分解しました。この「PowerPoint Does Rocket Science--and Better Techniques for Technical Reports」という記事では、（断熱材による破損の危険性を評価した）ボーイング社の報告書から正当な判断がされなかった理由として、報告書がPower Point のプレゼンテーション・スライドの形式で作られていたことが指摘されています。例えば、重要な情報が
[結] 2006年8月 - 結城浩の日記 機械的な作業の進め方
目次 2006年8月29日 - 『新版C言語プログラミングレッスン』 / 2006年8月27日 - 原稿 / 2006年8月26日 - 多忙なり / 2006年8月25日 - 夢の中の対話 / 多忙 / 祈り / 2006年8月24日 - 仕事 / 2006年8月23日 - 文章の品質を上げる方法 / 2006年8月22日 - 仕事 / 2006年8月18日 - トドちゃんを数えるPerlスクリプト / 2006年8月17日 - 新しい輝きと懐かしい香り / 2006年8月16日 - 本を書く仕事は大変だけれど、とても楽しい / 2006年8月15日 - 理解度 / 2006年8月14日 - 言葉 / 2006年8月13日 - 日曜日 / 2006年8月12日 - 仕事 / 2006年8月11日 - 書けたこと、考えたこと / べったら漬け / 2006年8月10日 - ビットパターンを反
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
