技術文書の書き方
howto-tech-docs.md 技術文書の書き方 このメモは、私（@ymmt2005）が長年にわたってソフトウェアプロダクト開発に関わってきて 2022年現在こうしたほうが良いと考えているベストプラクティスです。 科学的な分析等に基づくわけではない経験則であるため、今後も随時見直すことがありますし、 ここに書いてあることが常に正しいわけでもあらゆるソフトウェア開発に適するわけでもありません。 しかしながら、実務経験が豊富で、モダンな技術スタックに明るいエンジニアの経験則は一定の 役に立つのではないかと考えて記します。 技術文書とは ここでは、ソフトウェア開発で技術者が書くべき文書ということにします。 ソフトウェアエンジニアにも役割がいろいろあり、アーキテクトと independent contributor では書く文書が違うということはあるでしょうけれど、ここではごっちゃにします。
2013年PHPの話題を一挙に振り返るまとめ | Engine Yard Blog JP
2013年も本当にあとわずかになりました。 本日は今年話題になったPHPについての記事を公式のリリースやはてなブックマークから抽出してきた内容を元に今年を振り返ってみましょう。PHPにとって今年はどのような一年だったのでしょうか。 参考： 2012年のPHP周辺の話題振り返り | Engine Yard Blog JP PHPのバージョン 2013年中にリリースされたPHPのバージョンは5.3、5.4、5.5の3系統で合計29のリリースが行われました。リリースサイクルはほぼ毎月という形でした。またPHPの公式サイトがレスポンシブ対応の新しいデザインに切り替わりました。詳細は下記の通りです。 Version 5.4.11 2013/1/17 Version 5.3.21 2013/1/17 Version 5.4.12 2013/2/21 Version 5.3.22 2013/2/21
WebSocketを使っていない、サーバ無用なリアルタイム通信ライブラリ·Easy WebSocket MOONGIFT
Easy WebSocketはWebSocketではなくリアルタイム通信を行うJavaScriptライブラリ。 Easy WebSocketはnode.js製のオープンソース・ソフトウェア。HTML5界隈が賑わっているが、なかなか実用的なものは出てきていない。動画共有サイトのスマートフォン向けインタフェースやWebブラウザ用のゲームがせいぜいではないだろうか。 チャット画面 やはりデスクトップ向けのブラウザで一部のブラウザしか対応していないのが問題なのだろう。HTML5に関連した技術、WebSocketは特にサーバ側の準備も必要で扱いづらいイメージがある。そんな常識を覆すソフトウェアがEeasy WebSocketだ。 Easy WebSocketは正しくはHTML5の仕様ではないがWebSocketを擬似的に再現する。まるでWebSocketではないかと思えるほど、リアルタイムで更新され
今日から始めるCoffeeScript - KAYAC Engineers' Blog
こんにちは。毎年花粉症になりかけている飯塚です。 最近のNode.jsの普及などによってサーバサイドJavaScript界隈が盛り上がっています。 そんなホットなJavaScriptをラクにかつエレガントに書くためのCoffeeScriptという言語をチュートリアル風に紹介します。 何かしらのライブラリを自分で書く程度にJavaScriptで開発している人は絶対に使ったほうがいいと思います。 JavaScriptを知っていれば1-2時間程度で十分駆使できるようになります。 （2011/6/28：@m_satyr様にご指摘頂いた箇所を修正しました。） 目次 CoffeeScriptとは？ インストール Hello World 構文 関数 変数展開 Objectの生成 ループ 存在チェック ヒアドキュメント thisのバインド クラス 無名関数 {var} Tips ?の使い分け 存在チェック
Flexで同じHTTPServiceの結果を分岐
今回は Flexで同じHTTPServiceの結果を分岐 する方法です！ タイトルだけじゃ、何か分かりにくいですね ちょっと例をあげてみます！ まず、ボタンＡとボタンＢがあります これらのボタンＡとボタンＢは同じ HTTPService を 使って send されます もちろん同じ結果が取得されるのですが ボタンＡで押されたかボタンＢで押されたかを 判断したい！ と、いうことでその判断の仕方が今回のメモです！ 例は極端にボタンとしていますが、それ以外の場合でも もちろん使えます 今回は、例のように2つのボタンから send_test.txt という中身「kyuuri」とだけ書かれたテキストの 結果を取得して判断したいと思います それでは、まずはいつものようにソースから！ send_test.mxml <?xml version="1.0" encoding="utf-8"?> <mx:Ap
読書メモ『実践アジャイルテスト』 - 妄食転寝 as a QAエンジニア
書籍「実践アジャイルテスト」について、実際に読んだのはだいぶ前で、今年(2010年)3月下旬から5月にかけて、読書会に参加してたのですが、まとめを何も書いてなかったので今更ながら僕なりの読書メモを公開します。 本の概要 いわゆるアジャイル開発プロセスの中で、テスト担当者・QAエンジニアの役割や、テストがどう設計され、実施されるべきかを網羅的に説明した内容です。アジャイル関連の本はいくつも出ていますが、その中でテストをメインテーマに据えたものは和訳本ではこれがはじめてなのではないかと思います。 前半はアジャイルプロセスやテストの概要など大枠の話が多いですが、後半にはいろんなレベル(単体、API、GUI)での自動テストや、反復の各フェーズで実施する作業内容など、だいぶ具体的なプラクティスまで説明されています。 ちなみに読書会は、自分含め 9 名の参加者で、(当然ながら)テストが主な仕事の方が多
壁でもなんでも塗るだけでホワイトボードになる「IdeaPaint(アイデアペイント)」
でこぼこのない面であれば、壁であろうが柱であろうが机であろうがドアであろうが、とにかくなんでもかんでも塗るだけでホワイトボード化することができるという画期的な塗料がこの「IdeaPaint(アイデアペイント)」です。 実際にどういう場面で利用されているのか、価格はどれぐらいなのか、日本で入手するにはどうすればいいのか、などの詳細は以下から。 IdeaPaint | Dry Erase Whiteboard Paint for Home, School, and Work http://www.ideapaint.com/ 使用するシーンとしては、職場・学校・家庭の3つ。それぞれについて以下のような感じの使用を想定しています。 ・職場の場合 よくある会議室ですが、壁一面がホワイトボードに。 これは壁2面がホワイトボード化 目の前の壁自体がホワイトボード、電話のメモも簡単 背後の壁がホワイトボ
個人的に使いそうなPHP、CSS、HTML等のフレームワーク17個 - かちびと.net
個人的なメモです。今まであまり使って いなかったので少し使っていこうと思い、 いくつか自分でも使えそうなフレーム ワークを探しました。表題の通り、PHP、 CSS、HTMLやJS等しか僕は能力が 無いのでこの辺のフレームワークの まとめになります。 使いやすそう、使いにくそうというのは個人差が出そうだなぁと触ってみて思ったのですが、それぞれ良し悪しな感じもしたのでとりあえず気になったものだけメモしておきます。おそらく有名所ばかりだと思いますが個人的なメモなのでご了承下さい。 順不同です。 Blueprint CSSのフレームワークです。シンプルな設計ながら素敵なレイアウトが組まれている印象でした。 Blueprint Sass まだ触っていませんが、好評っぽいのでメモ。Railsみたいですが、CSSジェネレータ的な使い方もあるとの事でかなり気になる存在。Compassというのを一緒に使うの
シンプルに分かりやすくメモを作る·iroha Note MOONGIFT
iroha NoteはAdobe AIR製のフリーウェア。構造的にノートを書くときにはアウトラインエディタやマインドマッピングがよく使われる。一度に長文を書こうと思うとなかなか筆が進まなかったり、メンテナンスするのも大変だが、小さく分割することで可視化され、整理されるのだ。 ノートとリースでメモをする マインドマッピングソフトウェアは数多く存在し、高機能なものも多数存在する。だが多機能であると逆に操作に混乱してしまい、元々の目的だったノート作成がおぼつかなくなってしまう。そこで使ってみたいのがiroha Noteだ。 iroha Noteは日本製のAdobe AIRアプリで、Windows/Mac OSX/Linuxで動作する。左側にノートリストがあり、その右側にノートのコンテンツを作成する。付箋紙のようなリーフと呼ぶメモを貼り付け、各リーフをリンクさせてノートを作成する。 リーフ同士は線
【レビュー】目指せ究極の自動化、Windows自体をマクロする「WinMacro」 (1) 「WinMacro」のインストール | パソコン | マイコミジャーナル
「WinMacro」 コンピュータはもともと計算処理を自動化する目的で作られた魔法の箱であった。とはいっても数式や演算の世界であるので、PCを扱うことを日常とする我々一般人には、なかなかその自動化の恩恵を感じにくいのも事実。「WinMacro」では、計算処理のみならず、通常のPCでの作業を記録し再生することができる。「WinMacro」では、アプリケーションでの操作を含むWindowsの操作を記録し、これをファイルに保存し、再生することが可能になる。WordやExcelからブラウザまでその操作をそのまま記録し、再生してくれるので、アイデア次第ではいろいろな日常業務の手助けをしてくれる。 注意:本稿では、ソフトウェアのインストールを行っていますが、ソフトウェアの利用は使用者の責任で行ってください。 CodeplexのWinMacroのWebサイトへアクセスし右側の「Download」をクリッ
PHP :: 否定の!、is_null()、isset()、empty() の挙動の違い [Tipsというかメモ]
否定の!、is_null()、isset()、empty() の細かな挙動の違いをすぐ忘れるのでメモ。 check() という関数を作り、「空文字」「文字列の0」「数値の0」「false」「null」「空の配列」で動作確認を行った。 動作確認で使用したコード <?php $empty_str = ''; $str0 = '0'; $int0 = 0; $false = false; $null = null; $empty_array = array(); check('empty_str', $empty_str); check('str0', $str0); check('int0', $int0); check('false', $false); check('null', $null); check('empty_array', $empty_array); function ch
新米パパのための3冊
敬慕する切込隊長殿にジュニアが誕生したとのこと。おめでとうございます！ わたしのblogから、とーちゃん一年生にお役に立ちそうなエントリをピックアップしてみる。刹那的な人生感覚から、生きることに貪欲になったのは、嫁さんと子どものおかげ。「親になって一人前」というセンシティブな言葉があるけれど、すくなくともわたしにとっては真だった。親をやらせてもらっているおかげで、わたしは「まとも」に生きていられるのだから。 まずは、夜泣き対策。[入門編]と[応用編]がある。個人差があるので必ず、とは言えない。けれど、泣き続ける子どもに殺意を抱かないために、こういう対策がありますよと伝えたい。 世の中は便利になったもので、ズバリまんまのこういう本がある「赤ちゃんがピタリ泣きやむ魔法のスイッチ」。とりあえずいま泣いている赤ちゃんを静める方法（お包み＋シーッ）は有効だった。「抱っこして限界まで歩き続ける」とか、
新人にインターネットサービスの知識を問う - うせーのブログ運営ひとりごと
私のグループでは、サーバの知識、インターネットサービスについて知っていることが重要。 で、今年の新人さんにそのあたりを聞こうと思ったのですが、業務や研修が多忙だったので、質問票形式にしてみました。 完全に自分の思い込みが入ってますが、内容は↓ 【Webサービス、Webサイトについて】 以下のサービス、サイトについて、1～3で答えてください。 １→利用したことがある ２→言葉は知っている ３→聞いたことがない １．mixi 1 2 3 ２．twitter 1 2 3 ３．はてなブックマーク 1 2 3 ４．Gmail 1 2 3 ５．livedoor Reader 1 2 3 ６．livedoor クリップ
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
VSCode(Visual Studio Code)をメモ帳として使える拡張機能「VSNotes」が便利 | カレリエ
IT弁護士カンダのメモ。: Windows7でのキー入れ替え