注目！Web上のオープンドキュメントプラットフォーム·Substance MOONGIFT
SubstanceはWebブラウザ上で文書を作成したり、他人の文章にコメントするシステム。 Substanceはnode.js/JavaScript製のオープンソース・ソフトウェア。これは個人的に思い描いていたサービスの形に近いのかもしれない。最近、書籍の内容をGithubに登録しているケースをちらほらと見かけるようになった。リポジトリを使えば履歴管理も簡単だ。 閲覧画面 さらに他の人からコメントを貰ったり、コラボレーションすることもできる。だがやはりソースコードリポジトリでしかない。もっとドキュメントに特化したものがあればと思っていたが、Substanceがまさにそうだ。 SubstanceはWebブラウザ上でドキュメント書くことができるサービス&ソフトウェアだ。ユーザ登録すると誰でも文書を登録し、書けるようになる。文書はセクション、テキスト、画像、リソース、引用、コードといった具合にオ
HowToWriteAnEffectiveDesignDocument - 設計文書のうまい書き方
HowToWriteAnEffectiveDesignDocument - 設計文書のうまい書き方 目次 この文書について 設計文書のうまい書き方 なぜ設計文書を書くのか 良い設計とは何か 同僚の開発者に向けて書く 第 1 節に書くこと: プロジェクト/サブシステムの目的を示す 第 2 節に書くこと: 設計に使う高レベルなエンティティを定義する 第 3 節に書くこと: 個々のエンティティに関する低レベルの設計を書く 使い方 設定 モデル 相互作用 第 4 節に書くこと: 利点, 前提, リスク/懸念事項 マネージャ向けに書くこと 最後に 設計文書のうまい書き方 この文書について "How to Write an Effective Design Document" の日本語訳です. http://blog.slickedit.com/?p=43 推敲歓迎: 誤訳, タイポ, 訳語の不統一,
ジャーナリングが追加された「MongoDB 1.8」がリリース | OSDN Magazine
米10genは3月16日、オープンソースのドキュメント志向データベースシステム「MongoDB 1.8」を公開した。リクエストが多かったというジャーナリングなどの新機能が加わっている。 MongoDBはドキュメント志向のKey-Valueストア型データベースシステムで、SQLを使わない「NoSQLデータベース」と呼ばれるものの1つ。Python、PHP、Ruby、Javaなどから利用するためのドライバも公開されている。 最新版は2010年8月に公開されたバージョン1.6のフォローアップリリースとなる。最大の特徴は、新機能となるジャーナリングストレージエンジンの追加。これにより、クラッシュ時に普及作業が高速かつ安全に行えるという。 このほか、1.6で導入された分散運用機能のシャーディングを改善し、スプリットやバランスなどが高速化し、全体のシステムへの影響が抑えられたという。同じく1.6で加わ
MongoDBを使った開発のお供に。MongoDB版phpMyAdminとも言うべき「RockMongo」 | MOONGIFT | オープンソース・ソフトウェア紹介を中心としたITエンジニア/Webデザイナー向けブログ
RockMongoはPHP製のMongoDB管理インタフェース。 RockMongoはPHP製のオープンソース・ソフトウェア。NoSQLデータベースが注目を集めている。RDBMSに代わるとは思いがたいが、使いどころによってはNoSQLの方がパフォーマンスが高く、より高速なWebサービスを構築できるメリットがある。 ドキュメント一覧 そのNoSQLの一つして知られているのがMongoDBだ。ドキュメント指向データベースとしても知られ、複数サーバにまたがったようなスケーリングにも対応している。そんなMongoDBを扱う上で便利な管理インタフェースがRockMongoだ。 RockMongoはMongoDB用のPHP製管理インタフェースだ。MySQLで言う所のphpMyAdmin的存在だ。データベースの一覧、コレクションの一覧、ドキュメントの一覧など階層的に閲覧できるようになっている。もちろんコ
詳細設計書に何を書くべきか？ - Sacrificed & Exploited
詳細設計書の書き方については黙っていられないので、ちょっと意見を言わせてもらう。 私も「詳しすぎる詳細設計書 - SiroKuro Page」で示されているようなコードと１対１に対応したような詳細設計書は、書くだけ無駄だと思っている。ただ、ちゃんとした詳細設計書をつくるなら、処理内容（内部の処理の実装方法）の書き方をどのように実装言語に合せるかではなく、処理内容を一切書かないようにするべきだと考えている。 なぜなら、処理内容をいくら詳細に記述したところで、それは仕様ではなくコードであり、仕様の代わりに記述したコードでは、バグも含めて記述されているため、そのコードのみでは正しいか間違っているかを判定できないからだ。 コードの他にどういった動作が正しいのかを判定する基準が必要で、その基準が仕様であり、詳細設計書にはその仕様を記述する必要があると考えている。 現に、例として示された処理概要では、
詳しすぎる詳細設計書 - SiroKuro Page
「詳細設計書」と呼ばれるドキュメントがあります。各処理の入出力や処理概要を記載した文章です。 入力： 「性別と身長のペア」のリスト 出力： 男性の平均身長」と「女性の平均身長」の差 処理概要： 変数「男性の合計身長」「女性の合計身長」「男性の人数」「女性の人数」を 0 で初期化する 入力を受け取る 入力されたリストから要素を読み込む 入力されたリストの要素数だけ以下を繰り返す 要素を１つ読み込み、条件分岐する もし要素が男性なら、変数「男性の合計身長」に身長を加算し、変数「男性の人数」を１増加させる もし要素が女性なら、変数「女性の合計身長」に身長を加算し、変数「女性の人数」を１増加させる 次の要素を読み込む 「男性の合計身長」÷「男性の人数」−「女性の合計身長」÷「女性の人数」を、変数「計算結果」に代入する 出力する イメージとしては、こんな感じ。各社それぞれ、どんな詳細設計書を書いてい
JavaScriptによる開発が大規模化したらドキュメントを生成「Dox」 | MOONGIFT | オープンソース・ソフトウェア紹介を中心としたITエンジニア/Webデザイナー向けブログ
DoxはJSDocに対応したソースファイルからドキュメントを生成するライブラリ。 DoxはJavaScript/node.js製のオープンソース・ソフトウェア。JavaScriptがWebアプリケーション構築の際のメイン言語として使われるようになっている。その結果起こっているのがJavaScriptのコードの大規模化だ。 トップページ 大規模になれば当然、複数人での開発体制になる。そうなれば情報の共有やコーディングスタイルの統一などが必須になる。その一端を担うのがAPIドキュメントだ。ソースコードからドキュメントを生成するソフトウェアがDoxだ。 DoxはJSDocもサポートしたソフトウェアで、コンソールからコマンドを実行するだけでHTMLベースのドキュメントを生成する。ドキュメントにはMarkdownの記法が利用できる。システムとしてはnode.jsを使っており、npmを使ってインストー
暗黙のIntentを投げてみた - minghaiの日記
AndroidのフレームワークにはAndroidを強く特徴付けるIntentという仕組みがある。 IntentはActivityやServiceといった実行単位のコンポーネントを起動する場合に利用される。 プログラマはstartActivityやstartServiceといった関数を用いてActivityとServiceの起動を命ずるが、このとき引数にIntentを使うことにより実行対象を指定する。 Intentが優れているのはこの指定方法にある。 Intentは明示的にクラス名を指定することにより明らかに実行されるコンポーネントを指定することが可能だ。 しかし、より優れたIntentの利用方法は暗黙的なIntentの利用である。 暗黙的なIntentを用いることにより、直接実行コンポーネントを指定する必要がなくなる。 これによりコンポーネント間の結合はより緩やかな疎結合となる。 呼出元の
Apache CouchDB: CouchDB プロジェクト - 日本語訳
CouchDB プロジェクト Apache CouchDB は、RESTful HTTP/JSON API 経由でアクセス可能な、分散型で耐障害性の高い、スキーマ不要のドキュメント指向データベースです。主な特徴として、双方向での衝突の検出・解決が可能な堅牢なインクリメンタル・レプリケーション、JavaScript をデフォルトのビュー定義言語とするテーブル指向のビュー・エンジンを使ってクエリーやインデックス作成が可能なことなどがあります。 CouchDB は Erlang で記述されていますが、HTTP リクエストを実行できる環境なら、どんな環境からでも簡単にアクセスすることができます。さまざまなプログラミング言語・環境でのアクセスをさらに簡単にするためのサードパーティ製クライアント・ライブラリも多数存在します。 詳細については、「はじめに」と「技術概要」を読んでください。 使ってみる C
node.js
V8 JavaScript を用いたイベント駆動I/Oの実現 全てのリクエストに対して"Hello World"と返答するNodeで書かれたWEBサーバの例です。 var http = require('http'); http.createServer(function (req, res) { res.writeHead(200, {'Content-Type': 'text/plain'}); res.end('Hello World\n'); }).listen(8124, "127.0.0.1"); console.log('Server running at http://127.0.0.1:8124/'); このサーバを走らせるには、コードを example.jsというファイル名で保存し、下記のように nodeコマンドを実行してください。 % node example.js
memorycraft wiki: SproutCore ドキュメント翻訳
SproutCore? ドキュメント翻訳 SproutCore?( http://www.sproutcore.com/ )のドキュメントを翻訳します。 とりあえず私家版のつもりなので、適当です。 SprotuCore?はMITライセンスで提供されており、当翻訳Wikiもそれに準じます。
Chromium osをコンパイルしてみる - White scenery @showyou, hatena
http://journal.mycom.co.jp/news/2009/11/20/011/index.html http://sites.google.com/a/chromium.org/dev/chromium-os/building-chromium-os なんかchromiumosプロジェクトが公開されたので、せっかくなのでbuildだけしてみる 先に結論だけ書いとくと楽勝でした。GoといいGoogle関連のOSSはドキュメント読みやすいです。 環境はUbuntu 9.10(x86)です。当然ですが自己責任で。 2009/11/21 11:02 このエントリの後ろに追記しました 2009/11/21 13:11 記述ミスがあったので修正しました(thx vine_user!) コンパイルに必要なライブラリを揃える $ wget http://src.chromium.org/s
データストアの単体テストを書く手順 for 1.3.3 - うなの日記
GAEのSDKを1.3.3にバージョンアップしたら、データストアの単体テストがコンパイルエラーに! ドキュメントを見ると、どうやらテストケースの書き方が変わったらしい。(1.3.1 - 1.3.2はスルーしていたので、実はずっと前からかもですが) ということで、SDK1.3.0の頃に書いたテストケース作成手順を1.3.3での手順に更新しておきます。ユーティリティクラスが用意されて、以前より少ないコードで済むようになってますよ。 単体テストとは? 単体テストでは、 ローカルでGoogle App Engineのサーバーを起動することなしに、 データストアにアクセスするモジュールのテストを記述できます。 公式なドキュメントはこちら。日本語のドキュメントはまだ更新されていない(2010-05-01 現在)ようなのでご注意。 概要 必要なモジュールをプロジェクトに追加 テストケース内でLocalS
Google App Engine上でWicketを動かす - 矢野勉のはてな日記
Java, WicketGoogle App Engine for Javaのアカウントを取っておいたので、Wicketが動くかどうかチェックしました。 Wicketでは1.3の途中から、セッションストアがSecondLevelCacheSessionStoreという、ワークファイルに情報を書き出すタイプに変更になりました。ここがネックになるだろうと思っていたら、やっぱりファイル作成は規制されているとのこと。 で、HttpSession上にページ情報を格納する「HttpSessionStore」に切り替えてみたら、普通に動きました。 アプリケーション・クラスの設定はこのような感じです。 public class WicketApplication extends WebApplication { /** * Constructor */ public WicketApplication(
【Google App Engine】 Pagingをどうやって実現するか
JDOをそのまま使うとPagingができないことは前記事で述べたとおりだが、DatastoreAPIを使えば可能なので、今回はその方法について述べたいと思う。前記事と同様、請求書アプリを元に説明する。 KeyとCounter まず、基本となるEntityのInvoiceBaseとInvoiceの構造から。 InvoiceBaseは、Invoiceレコードを保持するする親のEntityだ。InvoiceBase（親）に紐づくInvoice（子）は１：ｎのOwnedな関連である。また、Invoiceレコードの件数を格納するcounterプロパティをもつ。InvoiceのKeyは、トランザクションで括る必要があってKeyを連結させているが、拙作ライブラリReflex GAEのAPI、keyUtils.getChildKey()を使って、連結されたInvoiceのKeyを取得している。（Refle
Google Sites: Sign-in
Not your computer? Use a private browsing window to sign in. Learn more about using Guest mode
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
プログラミング言語Scala 日本語情報サイト
Apache HTTP サーバ バージョン 2.0 ドキュメント