読みやすいREADMEを書く | Yakst
いくつかのオープンソースプロジェクトを公開している筆者からの、読みやすくユーザーにやさしいREADMEを書くためのアドバイス。 この記事は、Rowan Manning氏による「Writing a Friendly README」(2016/3/14)を翻訳したものです。 あなたのプロジェクトのREADMEは、かなり重要です。そこはプロジェクトに初めて来た人が大抵最初に見るであろう場所であり、唯一のドキュメントであることもよくあります。あなたのオープンソースプロジェクトにとってのREADMEは、企業にとってのウェブサイトのようなものです。ウェブサイトはユーザーエクスペリエンスの注目を集めるところですが、READMEがユーザー観点で考えられることはほとんどありません。 この記事では、分かりやすいREADMEを書くために役立ち、開発者(ユーザー)の要求に見合い、開発者がプロジェクトを初めて見たの
FAQ形式によるJavaScriptの本質がわかる超入門 - 風と宇宙とプログラム
はじめに JavaScriptは簡単な言語のようでいて、実は奥が深く、初心者にとってなかなかその本質がわかりにくい言語です。ここでは、JavaScriptの言語的エッセンスを理解できるようなものをFAQ形式で書いてみました。ご意見や誤り等を指摘してもらえたら嬉しいです。 なお、JavaScriptの標準化であるECMAScriptは、今年末にEdition 5 がリリースされる予定です。このFAQは、現在のバージョンであるEdition 3をベースにしています。 ECMAScriptって何ですか？ ECMAはEuropean Computer Manufacturer Association(欧州電子計算機工業会)の略で、標準化団体です。NetscapeのJavaScriptとMicrosoftのJScriptをベースに、純粋なプログラム言語部分を抽出したものをECMAで標準化したスクリプ
「ハッカーはVimを使う」 騙される若者たち
Eclipseがemacsやvimより優れている点を挙げてみよう。 ・リファクタリング機能が強力 ・CVSリポジトリの構成を直接覗ける ・デバッガがグラフィカル ・設定できる警告メッセージの種類が豊富。 ・復元機能が非常に充実している。 CVSのように以前の状態に復元すること、以前の状態の ソースコードとの比較も容易。CVS(Eclipse標準装備)/Subversionプラグインにもこの機能は存在する。 ・プラグインの数が豊富、膨大。 ・プラグイン開発環境もEclipse自体に用意されている。 ・ライセンス形態がCPLであり商用利用もしやすい。 ・上位版にWSADが存在する。 ・IBMのバックアップがついている。 ・Smalltalkで有名なVisualworksの影響を受けているため、 JUnitプラグイン(Eclipse標準装備)によるテストファースト、リファクタリングの他、eXtr
ロシアのソフト開発がいろんな意味で凄い - やまもといちろうBLOG（ブログ）
本来のミッションから少し離れて、本業の参考にと思って知己を得ていた先方の会社さんを訪問したり情報交換したりして過ごしていたんですが、いろいろ凄いです。「事情を日本のブログで紹介するよ」と言ったら、どこか明かさないという条件で許してくれました。 ● ソフトウェアの開発効率はあまり考えない シャチョーも担当者も現場の人も、効率は大事だけど開発に取り組む要員の創意工夫ややりがいを重視しているとのこと。現場レベルでは18ヶ月のプロジェクトが50ヶ月遅延した笑い話をしてくれたり、某ドイツの基幹系をロシア企業に提供する際にドイツ人の定義定義のやり方に嫌気が差し、そんなことだから戦争に負けるんだと掴み合いになった話を披露してくれました。 ● でっかいものを作りたがる どっちかっていうと日本では小さくて正確なコーディングを求めて、バージョンがアップするごとにコンパクトかつバグが少なくという方向で作業指示が
自覚 - naoyaの寿司ブログ
きれいなコードを書こうぜ、といってるのに対して製品の善し悪しに綺麗なコードがいいかどうかなんて関係ない、みたいな話とか 仕様書とかぜんぜん読まないから仕様書なんて全く必要ない、さっさとコード書けとかコードだけで語れ、とか TDD されてないからリファクタリングできないんだ、だからカバレッジ100%にするんだ、ぜんぶテスト書け、とか エンジニアは技術から出発して需要を考えない、だから問題から入れ、技術なんて関係ない、とか 企画屋は技術のことがわかってないから、夢物語りばっかり語るんだ、エンジニアがサービス作るべき、とか そういう、何かを反面教師に反対の考え方を支持するみたいなのは注目浴びやすいけど、視座をもうすこし中立にして考えると、だいたいおかしい。かくいうぼくもそんな風に煽ってる時期がありました、若さって怖いです ─ 中庸って知ってるか。伝統や、むかしから習慣として良しとされてきているこ
MeCab: Yet Another Part-of-Speech and Morphological Analyzer(形態素解析エンジン)
MeCab に至るまでの形態素解析器開発の歴史等はこちらをご覧ください メーリングリスト 一般ユーザ向けメーリングリスト 開発者向けメーリングリスト 新着情報 2008-02-03 MeCab 0.97 マルチスレッド環境で辞書を開くときの排他制御がうまくいっていなかったバグの修正 Windows版でインストール時に辞書の文字コードを指定できるようになった 一部のコンパイラで正しくコンパイルできなかった問題の修正 部分解析モードを変更するAPI の追加 (Tagger::set_partial()) ラティスの生成レベルを変更するAPI の追加 (Tagger::set_lattice_level()) 温度パラメータを変更するAPIの追加 (Tagger::set_theta()) 全候補出力モードを変更するAPIの追加 (Tagger::set_all_morphs()) 2007-
非同期通信で画像をロードする方法について - プログラミングノート
UITableViewなどのスクロール系のViewでサムネイル画像を出す場合、下記のような記述ではメインスレッドで画像がロードされるため、ユーザーのUI操作に影響が出てしまいます。 NSURL *url = [NSURL URLWithString:@"URL"]; NSData *data = [NSData dataWithContentsOfURL:url]; [instanceOfUIImageView setImage:[[UIImage alloc] initWithData:data]]; こういう場合は非同期通信を行うのが定石だと思いますが、参考になるサンプルがあまり無かったので試しに作ってみました。UIImageViewを継承したUIAsyncImageViewクラスです。 UIAsyncImageView.h 画像URLの指定と、通信中止用のメソッドのみ定義しています。
Android Market配布を目指しEclipseでHelloWorld！ (1/3) - ＠IT
Android Market配布を目指しEclipseでHelloWorld！：Androidで動く携帯Javaアプリ作成入門（1）（1/3 ページ） 本連載で、SDKとEclipseを使ってAndroidの携帯端末で動くJavaアプリを作成し、Android Marketでの配布を目指しましょう。ドコモやauでも端末が発売されるAndroid。その前に自分が作ったアプリを配布できるようにしておくと大きなチャンスです！ Android Marketでアプリを配布しよう 2008年7月、日本のケータイ市場（本連載では、携帯電話／PHS／スマートフォンなどの端末をまとめて「ケータイ」と表記します）に黒船として来航し、巻き起こされたiPhone旋風は記憶に新しいと思います。これまでになかったスタイリッシュなデザインと操作性で、新しい物好きが飛び付いたわけですが、それとは別の旋風がIT業界でも起こ
viでJava開発：Javaのためのvi設定方法 - builder by ZDNet Japan
エディタ「vi」は、Javaアプリケーションの開発環境としては用いられないことも多い。しかし、VimとAntを利用すれば、Javaの開発に適した環境に設定することが可能である。ここでは、次のJavaプロジェクトですぐに利用できるように、viのカスタマイズ手順を紹介しよう。 多くのソフトウェア技術者は、キャリアの中で一度はviエディタを使うことがある。それは、大学生のときかもしれないし、Windowsのデスクトップで高性能IDEを用いてコーディングしたソフトウェアを、製品版のUNIXマシンにインストールするときかもしれない。MicrosoftとべったりのIT企業の開発者でもない限り、最低でも月に一度はみなviを起動するだろう。viを熱狂的に愛している人がいる一方で、ひどい嫌悪感を抱いている人も多いということも事実である。しかし、たくさんカスタマイズをすれば、viはJava開発者にとってよりよ
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
Groovy Users - Can't force unboxing :((