タグ

ドキュメンテーションに関するya--madaのブックマーク (23)

  • 我々が失ったウェブ(The Web We Lost 日本語訳)

    以下の文章は、Anil Dash による The Web We Lost の日語訳である。 ハイテク業界やマスコミは、10億人規模のソーシャルネットワークや遍在するスマートフォンアプリの隆盛を普通の人たちの純粋な勝利、使いやすさと権利拡大の勝利のように扱ってきた。この変化の過程で我々が失ってしまったものが話題になることは稀だし、お若い方だとかつてウェブがどんなだったかご存知すらないかもしれないのは私も承知している。 そこで今では大方消えてしまったかつてのウェブを以下に紹介させてもらう。 五年前、共有される写真は大抵 Flickr にアップロードされ、そこで写真は machine tags を利用することで、人間ないしアプリやサービスででもタグ付け可能だった。単純な RSS フィードを利用することで、画像は容易に公開ウェブ上で見つけられた。そして人々がアップロードした写真は、クリエイティブ

    ya--mada
    ya--mada 2013/01/23
    おぉ、英語ってこういう書き方に適してるなぁと思ってしまったよ。
  • 米国人からコーディングについての怒りのメールを頂戴した - その手の平は尻もつかめるさ

    "米国人からコーディングについての怒りのメールを頂戴した" の補足 - その手の平は尻もつかめるさ ↑の方で補足いたしました。(2012.09.04 追記) 最近、英語のメールでよく怒られます。moznion です。 海を隔てて共同作業しているアメリカ人から、僕のコーディングについてお叱りのメールを頂いたので、 自戒の念を込めて邦訳して記します。 書いてあることは「当然」とも言うべき内容ですが、僕はその「当然」も守れていなかったのかぁ〜と反省。 以下、邦訳(意訳)です。 1. 郷に入っては郷に従え 既にソースコードが存在しているって事は、そこには同時にコーディングスタイルも存在しているってことだ。 その既存のソースコードに手を加える場合、別のコーディングスタイルを導入してはならない。 もし君がバックエンドのソースコードを弄っているなら、バックエンドのコーディングスタイルで記述するんだ。 フ

    米国人からコーディングについての怒りのメールを頂戴した - その手の平は尻もつかめるさ
    ya--mada
    ya--mada 2012/09/04
    いいなぁ、これくらいbootcampしてくれるリー・アーメイがいてくれれば!!
  • 「文は短く」は俗説か?ー〈短文信仰〉を屠り、短文のレトリックと長文のロジックを取り戻すために

    語の作文教育から文章読に至るまで、〈短文信仰〉とでも言うべきものがある。 文章表現を主題とする書籍の多くが「文は短く」と主張する。 「われわれ新聞記者は、だから、入社以来、先輩たちから、文章はできるだけ短く書くように、といわれつづけてきた。短く書こうとすると、主語と述語が近づき、事実がはっきりしてくる。込み入った因果関係のある事件などの場合には、とくにこの心構えが大切である。」(猪狩章『イカリさんの文章教室』) 「短く、短く、短く。/とにかくそれを絶えず念頭に置いてほしい。そして、短い一文に、全力を傾けていくことである。/ひとつの文に、あいまいさを残さぬことである。/文章を短くすることによって、意味のつながりを明瞭にすることができる。」(馬場博治『読ませる文章の書き方』) 「平明な文章を志す場合は、より長い文章よりも、より短い文を心がけたほうがいい。/私は、新聞の短評を書いていたころ

  • PHPもやらなきゃJenkins « BEAR Blog

    改名なのかフォークなのか、とにかくHudsonプロジェクトはHudsonとJenkinsに分かれました。(開発者はフォークではなく改名と主張していて、この辺りの話はinfoQが詳しいようです。http://www.infoq.com/jp/hudson ) ※前回の記事で紹介したphp-hudson-template はphp-jenkins-template に変わっています。 またPHPUnitで有名なSebastian氏がbuld.xmlを自動で作成してくれるPPW (PHP Project Wizard )というツールをリリースして、面倒だったプロジェクトの設定ファイルbuld.xmlの作成がとても簡単になりました。 Sebastian氏はhttp://jenkins-php.org/というPHPでJenkinsを使うためのガイドをするサイトも用意しています。以下はその補足です。

  • PHPでTDD&CIワークショップ、Jenkins + PHP の各種プラグインパート資料 - Yamashiro0217の日記

    はじめに この資料は「PHPでTDD&CIワークショップ」 http://atnd.org/events/16626 で @yamashiro が発表するための資料だよ。 ワークショップ参加者じゃなくても記事読むだけで完結するようには書いてあるよ。 概要としては、Jenkins を使って PHP のウンコレガシーなコードをいかに綺麗にして行くかということを説明する。 自画自賛だけど PHPMD とか PHPCPD の使い方の説明の資料としてもそこそこイケてる資料になってると思いました。まる。 この記事に書かれてることは、割とTemplate for Jenkins Jobs for PHP Projectsとかぶってるけど、プラグインを絞ってあるのと、一個一個のプラグインについて解説、また実際にエラーが起きたときにどうすればいいのか書くよ。 Java と Jenkins のインストールとJ

    PHPでTDD&CIワークショップ、Jenkins + PHP の各種プラグインパート資料 - Yamashiro0217の日記
  • ネットワークに自信のない人は東大講義の情報工学概論Aを見よう - 2012-01-28 - きしだのはてな

    東大にUTオープンコースウェアというのがあって、いろいろな講義資料が公開されています。 http://ocw.u-tokyo.ac.jp/ その中には動画授業があるものもあって、そのほぼすべてがおもしろいです。ただ興味がもてるかどうかという違いだけ。 その中で、情報工学概論Aというのがあって、授業内容としてはネットワークの概論になってます。まだ全部見てないけど、ネットワーク全般の話からTCP/IPの話、セキュリティまでの講義が公開されてるみたい。 こういう一貫した話がちゃんと語られてる講義というのはなかなか公開されてない、公開されてたとしてもネットワーク設定程度だったりするので、これは貴重だと思います。 http://ocw.u-tokyo.ac.jp/lecture?id=11314&r=609526321 ネットワークの勉強をしたことがない人は、テレビのかわりにこの講義を流しておくとい

    ネットワークに自信のない人は東大講義の情報工学概論Aを見よう - 2012-01-28 - きしだのはてな
  • エリート的な文章の書き方

    実際人はエリートではないし、またエリートである必要もない。 しかし、ある種の文章を書く場合、人は、あたかもエリートであるかのように書くのでなければならない。 2012 © URL must be http://disadvantaged.web.fc2.com/ (a slash is necessary) 1. はじめに 1.1. 当サイトの特徴 当サイト「エリート的な文章の書き方」は、初心者向けのサイトではありません。当サイトは、読み書きの苦手な人が問題を解決するサイトというよりも、ある程度読み書きができる人が問題を発見するサイトです。実際、当サイトは、それなりに文章を読める人を読者に想定した「結構ハードな読み物系のサイト」になっています。 ちなみに、当サイトは、このページですべてです。当サイトは、複数のページを行き来するような構造にはなっておらず、このテキスト一枚だけの構造になってい

  • 知るだけで天地の差が出る、テスト仕様書の必須項目&表現方法

    テスト仕様書で絶対に必要な項目リスト テスト仕様書に記述すべきものとして、以下の事項があります。 テストを実施した環境 実施するテストの内容 テストを実施するためのシステムの操作手順 テストの実行結果 個々のテスト項目を識別するための番号や記号(通し番号など) テストを実施した年月日 テストを実行した担当者 障害報告票番号(発生した障害の詳細を開発グループに報告する帳票の識別番号) まずはテスト環境について明記する テスト仕様書の先頭には、「テストを実施した環境」を記述します。ここでは、ハードウェア環境やソフトウェア環境、ネットワーク環境など、「どのような環境でテストを行ったか」を説明します。 ただし、テストを実施した環境を記述するだけでは十分ではありません。「顧客にとって必要な情報は何か」を考えるのです。ここで必要なのは、「要件定義書で規定した環境」との関係が分かることです。 なぜなら、

    知るだけで天地の差が出る、テスト仕様書の必須項目&表現方法
  • swtest.jp/wiki/tools - PukiWiki

    テストツール情報サイト † 不具合からの脱却!テスト自動化ツール研究 / 「テスト自動化ツール」選定の厳しい視点(無償の会員登録が必要) 2008/7/14 キーマンズネット / IT製品解体新書 http://www.keyman.or.jp/3w/prd/51/30002651/ (引用)Webシステムの品質に対する意識は高まってきているが、十分なテストの実施はそう容易なことではない。また、ソフトウェアは社会生活の中に奥深く入り込むようになったことから、その不具合がもたらす社会的・経済的損失は深刻さを増すばかりだ。こうした背景のもと、最近の開発プロジェクトではテスト工程を分業することが重要視されるようになり、ソフトウェアテストの自動化ツール効果的な利用に注目が集まるようになってきた。そこで今回はソフトウェアテストの自動化ツールにスポットを当てその基から最新動向までをわかりやすく解説す

    ya--mada
    ya--mada 2010/06/02
    テスト項目をバグとして登録すれば、BugTracでもいいわけですな。でも、テストは同じ項目を複数人でトライするものなので、ブライドされてないといけないんだよなぁ。的な。
  • 操作の繰り返しを利用した予測インタフェースの統合

    増井俊之, 中山 健 コンピュータソフトウェア, Vol.11, No.6(1994), pp.484-492. 論文中のシステムはJava対応ブラウザで実際に使ってみることが可能です。 2.3.4節を参照下さい。 GNU Emacs用プログラム dmacro.elも配付しています。 概要 テキストエディタにおいてユーザの操作の繰り返しから次の 操作を予測してマクロとして定義し実行する「動的マクロ生成機能」と, 辞書や文脈知識などを用いた各種の予測実行機能を 組み合わせて使用することにより,ふたつのキーを使用するだけで, 繰り返し操作の検出実行/予測手法の選択/選択された 予測結果の繰り返し適用といった各種の予測インタフェースを 実現できることを示す. 1. はじめに 近年,操作履歴などからユーザの次の操作を予測するインタフェースや, 例示によるプログラミング の技法を利用したインタフェ

    ya--mada
    ya--mada 2010/05/27
    それっぽく書くための参考に
  • PHPDoc - APIドキュメントの自動生成 - Do You PHP?

    現在では、PEARのAPIドキュメントなどはphpDocumentorが使われるようになっています。 仮に、あるプロジェクトで作成したクラスを他のプロジェクトでの使いたい場合、「ソースを追ってAPIを調べてね」なんてやってると余計な工数がかかってしまいますし、いつの間にか自分自身も忘れてるってことあります。そこで、何らかのAPIドキュメントがあると非常に楽ですよね。 Javaにはjavadocという強力なツールが用意されていますが、PHPでそれに相当するのが、PHPDocです。 PHPDocは、PHPDoc家、あるいは、PHP家のcvsリポジトリから入手することができます。 PHPDoc - Home http://www.phpdoc.de/doc/ PHP家のCVS http://cvs.php.net/cvs.php/pear PHPDoc家から入手したzipは、ブラウザから

  • ネスレという企業についての情報(歴史や研究開発、企業戦略、グローバル展開など)を探している。「ネスレ... | レファレンス協同データベース

    ネスレという企業についての情報(歴史や研究開発、企業戦略、グローバル展開など)を探している。 「ネスレ」をキーワードとして検索すると「ビジネスレター」、「ビジネスレポート」、「ビジネスレビュー」など 関係ないものがたくさんヒットして上手くいかない。探し方を教えてほしい。 や雑誌の特集、ネットの記事、論文など何でも良い。 1.まず、「日経テレコン21」など企業について調べることの出来る契約データベースで検索 →「企業検索」の画面で、「ネスレ」をキーワードにして検索すると2件ヒット。「ネスレ日(株)」を選ぶと 事業内容や沿革などの情報が入手可。沿革を見ると社名が「ネッスル日」から「ネスレ日」に改称されているので 「ネッスル日」もキーワードとして有効。 2.ネスレの正式名が「ネスレ日(株)」と分かったので、図書を調べる契約データベース「BOOKPLUS」で キーワードに「ネスレ日

    ネスレという企業についての情報(歴史や研究開発、企業戦略、グローバル展開など)を探している。「ネスレ... | レファレンス協同データベース
  • Module: Nokogiri

    Nokogiri parses and searches XML/HTML very quickly, and also has correctly implemented CSS3 selector support as well as XPath support. Parsing a document returns either a Nokogiri::XML::Document, or a Nokogiri::HTML::Document depending on the kind of document you parse. Here is an example: require 'nokogiri' require 'open-uri' # Get a Nokogiri::HTML:Document for the page we’re interested in... doc

  • mechanize-0.9.2 Documentation

    http://mechanize.rubyforge.org/ http://github.com/tenderlove/mechanize/tree/master DESCRIPTION The Mechanize library is used for automating interaction with websites. Mechanize automatically stores and sends cookies, follows redirects, can follow links, and submit forms. Form fields can be populated and submitted. Mechanize also keeps track of the sites that you have visited as a history. Dependen

    ya--mada
    ya--mada 2009/12/09
    MechanizeのAPIドック
  • Rails Framework Documentation

    Ruby on Rails 7.1.3.2 RDOC_MAIN.md railties/RDOC_MAIN.md Last modified: 2024-02-21 21:53:27 +0000 Welcome to Rails What’s Rails? Rails is a web-application framework that includes everything needed to create database-backed web applications according to the Model-View-Controller (MVC) pattern. Understanding the MVC pattern is key to understanding Rails. MVC divides your application into three laye

    ya--mada
    ya--mada 2009/12/03
    RailsのAPIドキュメント
  • IBMがWebアプリケーションのUIガイドラインとHTML/CSSのソースコードを公開

    業務アプリケーションがWebアプリケーションとして開発されるのは現在の大きなトレンドです。それに伴ってHTMLCSSによって業務アプリケーションの複雑なユーザーインターフェイスを構築する必要性が生じます。 しかし機能が豊富な業務アプリケーションのユーザーインターフェイスをHTMLCSSで構築するのはそれほど簡単ではなく、しかもそれをアプリケーション全体で統一し、優れたユーザビリティを実現するのはさらに手間のかかる作業です。 そうした業務用のWebアプリケーションのユーザーインターフェイスを構築するためのサンプルが豊富に含まれたガイドライン「IBM Lotus User Interface Developer Documentation」が、IBMから公開されました。 今回公開されたIBMのガイドラインは、同社のLotus製品群のユーザビリティを統一するための社内プロジェクト「One U

    IBMがWebアプリケーションのUIガイドラインとHTML/CSSのソースコードを公開
    ya--mada
    ya--mada 2009/11/06
    なんでこれがおススメなのかを知りたいので、それを訳してけろ。
  • 不動産購入に関する一つの(ショックな)気付き - ニューロサイエンスとマーケティングの間 - Being between Neuroscience and Marketing

    (感謝とお詫び) 昨夜、寝がけにぼそっと書いたエントリにたくさんのアクセスを頂きありがとうございます。私個人としては発見内容についてはオドロキでしたが、世の中的にはこれだけ買っている人も多く、もしかしたら常識なのかも、と思っていたので、ちょっと反応の大きさにびっくりしています。 お詫びと言うのは下の三茶のケースに上げた計算が、間違っていたことで(ローンのところで手数料が二度カウントになっていました)、この場合ですと、買う場合の損は約1000万円ではなく、200万円になります。今回自分が作ったスプレッドシートがブログに書くには複雑で、なおかつ極めて個別性が高いケースだったので少しでも一般化しようとして、つなぎ合わせるように新しく作ったのが失敗でした。(苦笑)下の表記は初めて読む人のために、元の表現を残す形で、修正しました。 みなさま、当に申し訳なし! ただ、全体としての考え、僕個人のケース

    不動産購入に関する一つの(ショックな)気付き - ニューロサイエンスとマーケティングの間 - Being between Neuroscience and Marketing
  • 情報量をとるか、デザインをとるか〜漫画雑誌の表紙の作り比較〜 - たまごまごごはん

    先日友人と雑誌の表紙の話をしていました。 端的に言うと、自分はどうも「月刊マガジン」と「別冊マガジン」を間違えちゃうよ、という話。 左が月マガ。右が別マガ。 まあ普段買っている人なら、作品が表紙に来ているので分かるとは思いますが、うん、これは初見ではちと分かりづらい。 つーか最初から知ってないとまず分からない。 表紙は、の顔です。 割と思い浮かべやすいのは、ジャンプ・サンデー・マガジン・チャンピオンの少年誌の表紙。あれはそれぞれのカラーがありながらも、とにかくごちゃごちゃしています。 それは雑誌の表紙にどれだけ情報量を載せられるかの勝負だからだと思います。あとグラビアアイドルを載せると売れるとかそういうの。 ところが、最近は「情報量」で勝負しない雑誌も増えています。雑誌のカラーが独自な場合が多いので、おそらくデザイナーさんの考え方・出版社の考え方次第なんでしょう思います。 「デザイン」重

    情報量をとるか、デザインをとるか〜漫画雑誌の表紙の作り比較〜 - たまごまごごはん
    ya--mada
    ya--mada 2009/10/21
    こうして並べると面白くなるんだな。なんでも並べてみよう的なアプローチで何かしてみようかな。
  • 見積もり・発注 - 技術情報Wiki

    発注/調達 † 値切ってはいけない 2009.3.6 確かに,プロジェクトには予算が決められており,その予算の枠内でやり遂げる必要がある。どうしても予算と見積もり金額が合わない場合には,入念に価格交渉を行い,発注者と受注者の双方が金額の妥当性について合意した上で確定させるべきなのだ。 そのためには,PMは出てきた見積もりを査定する能力が必要であり,かつ高い折衝能力が必要である。 はじめてのRFP 2008.2.4 調達用語 RFP,SLCP,SPAとか RFP(Request For Proposal:提案依頼書) SLCP−JCP98:Software Life Cycle Process - Japan Common Frame 1998 SPA(Software Process Assessment)

  • 日本語組版処理の要件(日本語版)

    1.1 このドキュメントの目的 すべての文化集団は,独自の言語,文字,書記システムを持つ.それゆえ,個々の書記システムをサイバースペースに移転することは,文化的資産の継承という意味で,情報通信技術にとって非常に重要な責務といえよう. この責務を実現するための基礎的な作業として,このドキュメントでは,日語という書記システムにおける組版上の問題点をまとめた.具体的な解決策を提示することではなく,要望事項の説明をすることにした.それは,実装レベルの問題を考える前提条件をまず明確にすることが重要であると考えたからある. 1.2 このドキュメントの作成方法 このドキュメントの作成は,W3C Japanese Layout Task Forceが行った.このタスクフォースは,次のようなメンバーで構成され,ユーザーコミュニティーからの要望と専門家による解決策を調和させるために様々な議論を行ってきた.