howto-tech-docs.md 技術文書の書き方 このメモは、私（@ymmt2005）が長年にわたってソフトウェアプロダクト開発に関わってきて 2022年現在こうしたほうが良いと考えているベストプラクティスです。 科学的な分析等に基づくわけではない経験則であるため、今後も随時見直すことがありますし、 ここに書いてあることが常に正しいわけでもあらゆるソフトウェア開発に適するわけでもありません。 しかしながら、実務経験が豊富で、モダンな技術スタックに明るいエンジニアの経験則は一定の 役に立つのではないかと考えて記します。 技術文書とは ここでは、ソフトウェア開発で技術者が書くべき文書ということにします。 ソフトウェアエンジニアにも役割がいろいろあり、アーキテクトと independent contributor では書く文書が違うということはあるでしょうけれど、ここではごっちゃにします。

はじめに こんにちは 筑波大学学園祭実行委員会に今年度所属していたpuripuri2100です。 学園祭実行委員会の中でも「内部向けシステムやサイトの運営、映像の作成や生中継」などの情報系を主な職務とする「情報メディアシステム局」という部門で作業をしていました。 学園祭実行委員会は通常学類11年生と2年生が所属するのですが、自分は1年生時には所属せず2年生になった今年度のみ所属するというかなり珍しいことをしていました。これには理由があり、既に情報メディアシステム局に所属して作業をしていた同学年の友人が昨年度末ごろに「今作ろうとしている物品管理システムの進捗が芳しくない」とこぼしていたのを聞き、それをヘルプで入ったためです。既に高校生の時に文化祭の準備委員会で使う物品に一意のIDを振ったうえで貸し出しを管理するシステムとソフトウェア2を作っていたことや、困っている友人を助けたいという気持ち、

リレーショナルデータベースが話題に挙がるとき、私は何かが足りないと思わずにはいられません。データベースはあらゆるところで使われており、その種類も、小規模で便利なSQLiteからパワフルなTeradataまで様々です。しかし、それがどういう仕組みで機能しているかを説明したものとなると、その数はごくわずかではないでしょうか。例えば「リレーショナルデータベース 仕組み」などで検索してみてください。ヒット数の少なさを実感できると思います。さらにそれらの記事は短いものがほとんどです。逆に、近年流行している技術（ビッグデータ、NoSQL、JavaScriptなど）を検索した場合、それらの機能を詳しく説明した記事はたくさん見つかると思います。 リレーショナルデータベースは、もはや大学の授業や研究論文、専門書などでしか扱われないような古くて退屈な技術なのでしょうか？ 私は開発者として、理解していないものを

要約 Wifiは無いに等しいと考えること。 (来場者1万強/日 なんていう状況下でWifiが動くと想定するのが駄目でした) 進捗管理する第三者を設けること。 ソースコード https://github.com/Na4Yu/EasyEats (RTDBのURLやSquareの個別キーは抜いているのでそのままは使えないです) はじめまして はじめまして、高校2年のNaYuです。 今回は文化祭で派手に失敗した話をさせて頂きます。 血反吐を垂れ流しながら書いていましたが、もし皆さんが文化祭を経て「この人のしたことをしなくて良かった~」なんて言っていただければ幸いです。(人の不幸は蜜の味) お願い 本記事は知見の共有を目的として個人が執筆したものであり、本記事の内容について学校、学校関係者への問い合わせはご遠慮頂けるようお願い申し上げます。 これを読んでいる後輩の方々へ この記事が私からの引き継ぎに

今年10月に発売されたNintendo Switch版『ウィッチャー３ ワイルドハント コンプリートエディション』。CD PROJEKT REDが手がけた大ヒットオープンワールドRPGであり、リッチなコンテンツとビジュアルを誇るAAAタイトルの移植は、ゲームそのものだけでなく技術的な側面からも大きな話題となった。 結果的に、Nintendo Switch版もメディアやプレイヤーから非常に高い評価を得ることとなったが、その移植にはさまざまな苦労があったことが想像される。移植を担当したSaber InteractiveのCEO Matthew Karch氏が、開発当時どのような問題に直面し、そして解決させたのかを海外メディアVentureBeatに語っている。 Saber Interactiveは、『World War Z』などを手がけたことで知られるデベロッパーだ。Nintendo Swit

楽天グループは自社で開発した低コスト通信技術をドイツの新興通信会社に輸出すると4日発表した。「仮想化」と呼ぶ通信機器をクラウド上のソフトウエアに置き換える技術で、これを使う通信網の設計・運用を独社から一括で請け負う。受注総額は2500億円超とみられる。仮想化は通信網の整備・運用コストを4割前後減らせるとされ、世界の通信会社が採用を進めている。普及に弾みがつきそうだ。子会社の楽天モバイルが携帯通

NTT東西の提供するFTTHサービス「フレッツ・光ネクスト」では、「IPv6オプション」を利用（IPv6オプションは2012年のある時期以降に新規開通した回線ではデフォルトで利用可能な状態になっている）することにより、NTT東日本、NTT西日本それぞれのエリア内でインターネットを経由しないフレッツIPv6網内折り返し通信が可能であることは、本ブログの読者の多くはご存知かと思います。 IPv6網内折り返し通信は、遅延やパケットロスが極めて少ないことや、PPPoEでのインターネット接続と比較して、スループットが高いこと、ISP契約が不要であることなどにより、安価で高品質なベストエフォートなVPN構築用回線として利用されることがあります。AS59105(HOMENOC)でも、拠点間の回線は Ether over IP トンネルやGREトンネルなどをIPv6網内折り返し通信の上で構築して利用してい

なぜ個人でウェブサイトを運用しているのかについて、整理しておきたい。 要約すると、以下の理由でやっている。 ウェブの技術を学べて費用対効果が高いから 表示されるコンテンツを制御したいから フィードバックの場と適切な距離を置きたいから かっこいいから コスパが高い 個人でウェブサイトを持って運用していくことは、学習意欲の高い多くの人にとって費用対効果の高い活動だと思う。 ほとんどの技術が無料で利用できる時代になってきているので、ここで言う費用というのは時間や労力のことで、効果というのは得られる知識のこと。その仕組みを用意するにあたって、ウェブサイトというものがどういう仕組みで動くかということが、一通り理解できる。この辺の分野を本職とするような人であれば、こういうことは最低限理解しておいてほしいし、何なら採用面接でもこういったことを質問する・される機会がある。 学習コストについて述べたけれど、

株探のミンカブ・ジ・インフォノイド、役員からライブドア買収を聞いちゃった知人がインサイダー取引をしていた件でお詫び

Suicaの凄さ サービスを落とさないための「自立分散高速処理技術！」 ものすごい処理量をこなす緻密な速度改善 お金を扱うからこそ間違わない仕組み 当時は最先端の非接触ICカードを採用 非接触ICカードの歴史 年寄りも当たり前に使えるサービス だからSuicaは６０００万枚も普及した まとめ Suicaの凄さ ものすごい処理量（1日4000万件） 全然サービスが落ちない 年寄りも使っている Suicaがない社会なんて今や想像できないですよね？東京でSuica持ってない人はいないくらい普及していますし、レストランやコンビニでSuicaを使って買える場所も普通になってきました。普通に考えて、1日4000万件も処理して0.1秒以内に処理を完了させないといけないシステムなんて無茶苦茶難しくないですか？しかも、Suicaがリリースされたのは2001年です！ちょこっと調べてみたすごいブレークスルーの数

「これ，いったい何の本なの？」店頭でぱらぱらめくっている人は，本書の中身の得体の知れなさを見てそう思うはずだ。 『ハードウェアハッカー』というから，エレクトロニクス系のちょっと変わったハード作りや改造のノウハウや，それにまつわる各種エピソードかな，というのが普通の期待だろう。そして，たしかにそのとおりではある。あるのだけれど……その幅と深さが尋常ではないのだ。 イノベーションとハッカーの意義 そもそもハッカーというと，悪い印象を持つ人も多いだろう。一般にハッカーといえば，なにやら他人のコンピュータに侵入して，ファイルを勝手に消したり改変したり，データを盗んだりする犯罪者だ。じつは著者バニー・ファンも，そうした色眼鏡で見られてきた。 でもその著者を含め，誇りをもってハッカーを名乗る人々がいる。というより，そちらのほうが正規の意味だ。ハッカーは，さまざまなものを独創的なやり方でいじり，その仕組

世界33の国と地域を対象にした人材のミスマッチに関する調査で、日本は、ＩＴ分野などの高度なスキルを持つ人材を確保するのが最も難しい国だと指摘されました。 それによりますと、求人が過剰な状態を「10」、人手が過剰な状態を「０」、均衡がとれた状態を「５」とした場合、日本は去年より0.1ポイント上昇して最大の「10」となりました。 これは、スペインやルクセンブルクと並んでＩＴ分野などの高度なスキルを持つ人材の確保が最も難しい国であることを示しています。 その理由として、労働人口の減少のほか急速な技術の進化に日本の人材が持つスキルが追いついていないことを挙げ、背景には、横並びの給与など従来型の評価制度や日本の教育内容に問題があるとしています。 一方、今回の調査で人材の均衡がとれていたのは香港やインドで、外国から人材の受け入れを進めていることなどが背景にあるとしています。 記者会見したヘイズの日本法

コソッとカバンに商品を忍ばせた 店舗の利用手順はこうだ。客が入口でSuicaなど交通系ICカードをかざすとドアが開く（一度に入店できるのは3人まで）。入口から出口までは一本道になっており、棚から商品を取りながら進む。棚には、飲料や菓子など約140種類の商品が並んでいる。 出口にある端末に交通系ICカードをかざすと、備え付けのディスプレイに購入した商品名、合計金額が表示される。そのまま決済が完了すれば、出口ゲートが開く仕組みだ。実証実験では、ICカードの残高が不足している場合、商品を棚に戻して一度退店する必要がある。 天井には16台、棚には約100台のカメラがあり、入店した客を追跡する。棚から取り出した商品も同じカメラで認識している。商品そのものに電子タグなど特別な仕掛けはない。技術開発には、ベンチャーのサインポスト（東京都中央区）が協力している。 意地悪な記者は、カメラが誤認識しないか試し

研究者やグーグル、Apple、CYBERDYNEなど名だたる企業から人材が集まる（画像をタップすると高解像度版を表示します）。 取材をもとにBusiness Insider Japanが作成 メルカリが上場し、日本で有数のユニコーン（未上場で企業価値10億ドル以上の企業）とされるプリファード・ネットワークス（以下、PFN）。 トヨタやファナック、日立製作所など日本を代表する技術系大手企業から資金を調達し、事業面でも連携を進める、いま日本でもっとも注目を集めるスタートアップの1社だ。 PFNが開発したオープンソースの深層学習フレームワーク｢Chainer｣は、世界中の企業や開発者に利用され、AIの研究開発の最前線に食い込んでいる。 そのPFNは、プリファード・インフラストラクチャー（PFI）から分社する形で2014年3月に創業、現在の社員数は150人を超えた。そして、いまなお優秀な技術者が集

仕事中にウトウトしてきたら、部屋の温度が自動的に下がって眠気を吹き飛ばす――。ＮＥＣとダイキン工業は２５日、オフィスでの居眠りを防ぐシステムを共同開発すると発表した。２０２０年にも実用化し、生産性の向上をめざす企業に売り込む考えだ。 システムの仕組みは、こうだ。まずはパソコンの画面にカメラをつけるなどして、働き手のまぶたの動きを追う。まぶたの動き方に変化が出れば、眠気におそわれ始めたと判断。部屋のエアコンの設定温度を一時的に数度下げて働き手に刺激を与え、目覚めを促す。 ＮＥＣは得意の顔認証技術を生かし、まぶたの動きを追う技術を開発する。まぶたの動きの分析には人工知能（ＡＩ）を使う。 ダイキンはエアコンを制御する技術を担当し、眠気を感じた働き手だけに風をあてるエアコンの開発も検討する。 まぶたの動きは記録するが、だれのデータか特定できないようにするという。「勤務態度の監視には使えないようにす

大手自動車メーカーのホンダは、開発を続けていた２足歩行の人型ロボット「アシモ」の開発をとりやめていたことがわかりました。今後は介護支援などより実用的なロボット技術の開発に力を入れる方針です。 その後、平成23年まで７代にわたって改良型が発表されましたが、関係者によりますと、ホンダは開発をすでにとりやめていて、研究開発のチームも解散したということです。 ２足歩行の人型ロボットをめぐっては、ソフトバンクグループが買収したアメリカの「ボストン・ダイナミクス」が高い運動性能を持つロボットを発表するなど参入が相次ぎ、競争が激しくなっています。 ホンダとしては、より実用的なロボット技術の開発に力を入れる方針で、今後は、アシモの開発で培った高度なバランス性能や、運動を制御する技術を応用し、転倒を防止する機能をもつバイクや、介護を支援する装着型のロボットの開発を進めていくとしています。

アサヒパワーサービス（栃木県小山市、鈴木健治社長）は、手で持たない日傘「ｆｒｅｅ　Ｐａｒａｓｏｌ（フリーパラソル）」の試作機を開発した。飛行ロボット（ドローン）にシートを装着した“ドローン傘”で日差しを遮る。価格は３万円程度を予定し、２０１９年中にも商用化する。将来は雨傘として使えるよう、モーター部に防水加工などを施す方針だ。 完成した試作機は、特定のマークを追尾する自動操縦仕様。傘となる小型ドローンで撮影した映像を、人工知能（ＡＩ）を使った自社のソフトウエアで解析してマークを識別する。鈴木社長は「プログラムを改良し、人の頭部を識別できるまでレベルアップしたい」としている。 製品化を目指すドローンの直径は約１５０センチメートル、毎時５０００ミリアンぺアのバッテリーを１基搭載する。重さは約５キログラム、飛行時間は２０分程度。今後は部品を軽量化し重さを１キログラム、飛行時間１時間を目指す。事故