テスト駆動開発(TDD)の一般化とGitHubの登場によって、機能追加の際にコードとテストを同時に実装する(そして、両者を一括してmasterにmergeする)という開発手法が一般化してきました。 しかし、「良いプログラム」の要素を構成するのは、コードとテストのみではありません。動作するコードと、その品質を担保するためのテストがあったとしても、適切なドキュメントがなければ、ユーザーはそのプログラムをどうやって使ったら良いかわかりません。 つまり、ユーザーに使いやすいプログラムを継続的に開発/提供しようと思うと、 コード テスト ドキュメント の3点セットを提供する必要があるのです注1。 今日のJSXが抱えている最大の課題は、ドキュメントが不足しているという点にあります。その原因は、「機能追加」の際にコードとテストのみを実装してmasterにmergeすることを繰り返す一方で、ドキュメントは
AngularJS 2.0 Data Persistence Design Doc Status: Draft Authors: Jeff Cross (crossj@google.com, jeff@nrwl.io) Ritchie Martori (ritchie@strongloop.com) Anant Narayanan (anant@firebase.com) Objective This document is concerned with the design of data-focused AngularJS v2.0 modules, considered to be...
API Blueprint. A powerful high-level API description language for web APIs. API Blueprint is simple and accessible to everybody involved in the API lifecycle. Its syntax is concise yet expressive. With API Blueprint you can quickly design and prototype APIs to be created or document and test already deployed mission-critical APIs. Tutorial Tools section Focused on Collaboration API Blueprint is bu
Best Practice Recommendations for Angular App StructureProposal: Change angular-seed, yeoman/generator-angular, (the Google-internal example go/nghellostyle), and other demo apps to model the following directory structure. Eventually, develop tooling to make development more efficient using assumptions based on these conventions. Motivation:Our toy and demo apps currently group files functionally
This page is for an older version of Jasmine (2.0) The current stable version of Jasmine is: 3.10 - You can also look at the docs for the next release: Edge Jasmine is a behavior-driven development framework for testing JavaScript code. It does not depend on any other JavaScript frameworks. It does not require a DOM. And it has a clean, obvious syntax so that you can easily write tests. This guide
来年は、インプットあたりのアウトプットの増加を目指しています。具体的なアウトプットとしては、ブログを書くこともその1つですし、公開・非公開を問わずに効率的にドキュメントを書いていくこともあります。その中で効率的にドキュメントを書くには、バージョン管理を含めドキュメントを管理する仕組みが必須だと思います。以前、原稿を書いていた時は、Git+MS Wordで書いていました。版管理出来るという点では良いのですが、Wordということで執筆出来る端末も限定され、またフォーマット変更もしづらいので改善を考えていました。 そんな中で、IT系の物書きの人たちの間でReVIEW良いよという話を何度も聞いたので試してみようと思いました。一方で、記述のデファクトは今後はMarkDown基本になると思うのでそちらもマスターしたいと考えています。Twitterで何気なく呟いたら、@masawadaさんにmd2rev
先週末のことだけどSassの基本的な機能を解説した公式のページをSassの基本として日本語に訳した。Sassの公式ウェブサイトがリニューアルした後、チュートリアルがなくなっていて、その代わりに書かれたSass Basicsの翻訳。以前、Sass - チュートリアルを訳したので、その流れで。 以前のチュートリアルからは全体的に内容が薄くなっているけど、その一方で@extendのことが追加されていたりもする。Sassの一般的な機能がコンパクトにまとまっているので、Sassをこれから使うという人には一読する価値はあるはず。Sassを既に利用している人には発見はほとんどないと思う。 3.3出たらまた変わりそう。 チュートリアルの方は新たな文書があることを追記だけして、そのまま残してある。けど、301で飛ばした方が良いかもしれないなぁ。
Harry Roberts氏によるCSSガイドライン(High-level guidelines from writing manageable, maintainable CSS)のドキュメントが素晴らしすぎたので、勢いで翻訳してみました。(ロシア語、中国語、フランス語に引き続いて4番目...) 一般 CSS 注釈、アドバイス、ガイドライン at github 個人的な主観で見所を選んでみると、以下のような感じです。 クラスの名前付け方法(ネーミングルール) セレクターの設計、考え方 !importantの使い所 最近見るようになって来たBEM命名法についても説明してあります。 そもそもWebのデザインをどうするかという問題は置いておくと、CSSを書くという事は、どうやってそのデザインを実現するかというHowTo的なものと、どうのように名前付けやエレメントの設計を行なってメンテナンス可能
Latest Published Version: http://www.w3.org/TR/html51/ Latest Version of HTML: http://www.w3.org/TR/html/ Latest Editor's Draft: http://www.w3.org/html/wg/drafts/html/master/ Previous Versions: http://www.w3.org/TR/2014/WD-html51-20140204/ Editors: WHATWG: Ian Hickson, Google, Inc. W3C: Robin Berjon, W3C Steve Faulkner, The Paciello Group Travis Leithead, Microsoft Erika Doyle Navara, Microsoft Ed
The Internet Explorer 11 guide for developers is the overview of the developer features and standards included in IE11. The developer guide also describes the latest features available to developers of Windows Store apps using JavaScript on Windows 8.1. Use the documentation and samples in this guide to take full advantage of these new features. Important The contents of this guide apply to: IE11
CSSのメタ言語、Sassベースで作られた便利なフレームワーク、それがCompass。 Compassの設定ファイルはRubyファイルです。 これはRubyを知っていれば色々なことが出来るということなんですが、逆にRubyを知らないと取っつきにくさがあると思います。 それで損をしてしまうのはあまりに勿体無いので、オレオレリファレンスを書いてみました! ※この記事は完全な和訳ではありません。 基本的な書き方 コメント Windowsユーザー向けの注意 設定項目 動作に影響するもの URL関連 Sprite画像の自動生成用 コマンドラインでのオーバーライド コマンドライン経由で渡される設定の検査 Compass 用プラグインの読み込み コンフィグ関数 add_import_path asset_host asset_cache_buster watch コールバック on_sprite_sav
Opening the Web Platform We are an open community of developers building resources for a better web, regardless of brand, browser or platform. Anyone can contribute and each person who does makes us stronger. Together we can continue to drive innovation on the Web to serve the greater good. It starts here, with you.
SinonJSDoc 1.0 Welcome to Sinon.JS Documentation.¶ Contents:¶ 各Sinon.JSファイル¶ sinon.js sinon/spy.js sinon/stub.js sinon/mock.js sinon/collection.js sinon/assert.js sinon/sandbox.js sinon/test.js sinon/test_case.js sinon/match.js sinon/util/event.js sinon/util/fake_server.js sinon/util/fake_server_with_clock.js sinon/util/fake_timers.js sinon/util/fake_xml_http_request.js sinon/util/timers_ie.js sin
ドキュメントコメント、書いてますか? githubで公開するライブラリなど、特に人に見せるようなコードには、きっちりコメントを入れておきたいものですね。 せっかくなら世界中の人に使ってもらいたいので、頑張って英語で書きたい。 でも、やっぱり英語には自信がなくて、何度も辞書や既存のドキュメントを見直してしまう…。 こんなムダな日々におさらばするため、代表的なドキュメントをいくつかピックアップして、頻出表現をまとめました。 もうこれで迷わない! …いや迷うけど、それでも負担はグッと減るはず! 参考ライブラリ Java – Java Platform SE 6 Closure Library – Closure Library API Documentation Foundation – Foundation Framework Reference UIKit – UIKit Framewor
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く