技術文書の書き方
howto-tech-docs.md 技術文書の書き方 このメモは、私（@ymmt2005）が長年にわたってソフトウェアプロダクト開発に関わってきて 2022年現在こうしたほうが良いと考えているベストプラクティスです。 科学的な分析等に基づくわけではない経験則であるため、今後も随時見直すことがありますし、 ここに書いてあることが常に正しいわけでもあらゆるソフトウェア開発に適するわけでもありません。 しかしながら、実務経験が豊富で、モダンな技術スタックに明るいエンジニアの経験則は一定の 役に立つのではないかと考えて記します。 技術文書とは ここでは、ソフトウェア開発で技術者が書くべき文書ということにします。 ソフトウェアエンジニアにも役割がいろいろあり、アーキテクトと independent contributor では書く文書が違うということはあるでしょうけれど、ここではごっちゃにします。
数学・物理学の知識を理解するための「足りない知識」を「ツリー構造」で掘り下げていける学習サイト「コグニカル」レビュー
分野が広く、さまざまな知識を求められる数学や物理学。これらの知識をツリー構造により分からないところまでひたすら掘り下げて、基礎の基礎から学ぶことができる学習サイトが「コグニカル」です。一体何かどう学べるのか？ということで、実際にコグニカルを使ってみました。 コグニカル https://cognicull.com/ja コグニカルのトップページはこんな感じ。「ばねの弾性力による位置エネルギー」「位置エネルギー」など、数学・自然科学・工学のさまざまな知識が353個並んでいます。 試しに「熱振動」をクリックすると、「熱振動とは、分子など、原子の集合で生じる原子の振動のことです。」と、熱振動について記述されたページが表示されました。また、分子と原子が振動している様子のイメージがアニメーションで表示されています。 読み進めていくと、「説明が理解できない場合」は「以下の知識が不足している可能性がありま
主人公／ラスボスの視点からRPGを題材にサイバーセキュリティを解説した人気連載を無料提供
主人公／ラスボスの視点からRPGを題材にサイバーセキュリティを解説した人気連載を無料提供：人気連載まとめ読み！ ＠IT eBook（57） 人気過去連載を電子書籍化し、無料ダウンロード提供する＠IT eBookシリーズ。第57弾は、5章にわたってRPGを題材にサイバーセキュリティについて理解を深めてもらうという異色連載『RPGに学ぶセキュリティ』です。時に主人公の視点から、また時にはラスボスの立場に立って、RPGを見直してみると、サイバーセキュリティとの関連性が浮かび上がってきます。 「なぜ、RPGからセキュリティを学べるか」というと、その理由は、セキュリティ自体が、ITに詳しくない方からすると異世界やファンタジーのようなものだからだ――今回紹介するeBookでこのように述べるのは、セキュリティ企業ラックの武田一城氏だ。過去に筆者は、戦艦大和や戦国時代の城郭、今回のRPG に近い漫画やアニ
「GitとGitHub用語」の可愛いイラストを使用した解説に対して圧倒的わかりやすさを感じる人たち
ちづみ @098ra0209 Webサイト屋さん👩🏻💻と古民家🏡のカフェ&コミュニティスペースimawoを運営しています/WordPress/figma/半Web半DIY生活 🛠 SoftwareDesignでgitイラスト連載中📖/ちゃんとプロになるWordPress基礎入門出版 ちづみ @098ra0209 去年Gitまわりを触った時に用語多いし意味がわけワカメで、うへぇ🤢てなったけど、いやぁでもこういう類はアウトプットを見据えたインプットが定着が早いし手が動くよなぁと思って「これだけはおさえよう」みたいなのを誰でもわかるように意識して書いて覚えたやつが出てきた…なつい🍉 pic.twitter.com/XHxagBso8S 2019-08-17 20:59:58
山田孝之の使い方が正しすぎるNHK #植物に学ぶ生存戦略 「ツユクサは1人セックス」「プーチンはかわいい」「これは私の胸毛です」 - Togetter
NHK Eテレ編集部 @nhk_Etele 【今夜11時 植物たちの生存戦略】 植物たちの謎めいた生態を読み解き、 人生のヒントを探る番組。 見たことのない映像が、あなたのもとに！ 話す人は #山田孝之 さんです。 「#植物に学ぶ生存戦略」#Ｅテレ 9月27日(木)午後11時 www4.nhk.or.jp/P5076/x/2018-0… 2018-09-27 18:01:01 リンク 植物に学ぶ生存戦略 話す人・山田孝之 - NHK 植物に学ぶ生存戦略 話す人・山田孝之 - NHK 美しき植物たちの謎めいた生態を読み解き、人生のヒントを探る異色の番組。話す人は俳優の山田孝之。展開の予想がつかない、見たことのない映像がいま、あなたのもとに！ 240
「ちびぷよで理論値47連鎖しました」すげー！！となる中、大学教授から「地震に関する講義に使いたい」との申し出が
あず♀(˙˘˙̀ 🥝 @as27msk @warabi_pupuyo ここまで組み上げるのに完成直前で回しミスって自滅とか時間かけすぎて操作が早すぎて暴発とかとにかく何回も死にまくった(T . T)昼からずっとやってた 2018-08-17 03:31:12
自分の子どもに「プログラミングってどうすればいいの？」と聞かれたら……すぐに始められるプログラミング教育ツール - GeekOutコラム
学習指導要領の改訂により、2020年度から小学校でもプログラミング教育が必修化されます。ここ2～3年で、子ども向けのプログラミング教室が急増し、子どもを持つ親へのアンケートでも、子どもに習わせたい習い事の上位にプログラミングが挙げられるようになりました。 ITエンジニアとして働いている方の中にも、自分の子どもにプログラミングを学ばせたいと思っている方は多いことでしょう。そこで、「子どもにプログラミングについて伝えるにはどうすればいいか」「子どもに『プログラミングをやってみたいんだけど、どうすればいいの？』と聞かれた場合に、何から始めさせればいいのか」というテーマを軸に、最新の子ども向けプログラミング教育ツールを紹介したいと思います。 プログラミング学習によって得られる論理的な思考力 プログラミングを学ぶことの利点はいくつもありますが、中でもよく言われるのが「論理的な思考能力（ロジカルシンキ
高校で使われているプログラミングの教科書を全部購入して比較 (情報の科学)
Jul 29, 2018 義務教育ではないものの、高校ではプログラミング教育を含むIT教育が「情報」という教科として2003年から実施されてきています。 今回は情報の教科書を再び大人買いしましたので、全ての教科書に目を通した上でそれぞれの教科書の特徴を見ていきます。 以前の記事でも触れましたが、教科書は教科書会社が学習指導要領を元に作成し、教科書検定を受けたものが各学校によって採択され使用されます。 教科書に掲載されているからといってその内容がそのまま授業で行われるわけではないのは注意が必要です。 今回はその中でも平成28年に検定を受け、現在使用されている下記の6つの教科書を紹介します。 前置きが長くなりそうなので、各教科書について見たい方はジャンプしてください。 東京書籍 - 情報の科学 [情科306] 実教出版 - 最新 情報の科学 新訂版 [情科307] 実教出版 - 情報の科学 新
HTML5 入れ子チートシート | 吉川ウェブ
HTML 5.2のそれぞれの要素が入れ子にできる「子要素」、包含されることが可能な「親要素」の一覧のルールを視覚化して表示します。 ※1 a要素の親要素が包含可能であること※1 audio要素の親要素が包含可能であること※1 canvas要素の親要素が包含可能であること※1 del要素の親要素が包含可能であること※1 ins要素の親要素が包含可能であること子要素省略※1 map要素の親要素が包含可能であること※1 noscript要素の親要素が包含可能であること かつ body要素の子孫であること子要素省略※1 video要素の親要素が包含可能であること ルート要素＆文書メタデータ html 親 子 head 親 子 title 親 子 base 親 子 link 親 子※HTML 5.2から可能。フレージングコンテンツが期待される場所※head要素の子孫であること meta 親 子※he
アホの子教えるのは楽しかった
学生時代バイトで個人指導の塾講師をやっていて、座ってられない＆話が聞けない中2とか、アルファベットのaとdとbの区別が付いてなくてbog とかdopple とか平気で書いちゃう中3とかを担当していた。 そういうレベルの子供でも、ちょっとした一言というかきっかけが見つかれば変わるし、偏差値27から50超のだいたい普通レベルまでもってくことは、片手間の個人指導の大学生バイトでも割と難しくなかった。 逆に私にとっては、普通の子を出来る子にする方が簡単じゃなかった。本人に勉強への自発的意欲があって家庭の協力があれば偏差値60超くらいまではいけたけど、そこから先は元々の素養がないとダメかなぁという感じだった。個人的な体感だと65を超えるのは元々の素養が大きく左右するなぁと思っていた。 アホの子を普通の子にする役目は、他のバイト講師仲間の誰もがやりたがらなかった。私はアホだったからそっちのが性に合って
ボードゲームの説明書に学ぶ、「伝わる」引き継ぎ資料の作りかた 実践編｜ミヤザキユウ／ボードゲームデザイナー
引継ぎ資料を作るときには、ボードゲームの説明書の作り方を真似しましょう。すると誰でも分かりやすい資料ができて、後任の人がハッピーになって、感謝されて、あなたもハッピー。 本noteでは、そんなハッピーを生み出すために、ボードゲームの説明書の構造 & 引き継ぎ資料への作り方を解説していきます。ゲームを作る方なら、説明書をデザインするときも参考になるかもしれません。 まずは実際の説明書を見てみましょう。 下記の画像は、僕が以前つくった「切り裂きジャックは誰？」というゲームの説明書です。「B5１枚に収める ＆ フォントは最低でも7pt」という制約のため詰め込み気味ですが、内容は結構わかりやすくなっているかと思います。 これを踏まえて、各項目について解説していきます。 １．ゲームの名前おそらくどんな説明書でも、最初に書かれているのはそのゲームの名前ではないでしょうか。 引き継ぎ資料も同様に、最初は
技術書を作るための技術スタック | メルカリエンジニアリング
Mercari Advent Calendar 2017の3日目はmhidakaがお送りします。 Advent Calendarで空いてるところに収まったら12月3日は日曜日ということで、エンジニアの趣味的な話です。 筆者は技術的なブログや書籍を書くかたわら、技術書のためのイベントなどを開いてます。 技術を追求すること、プログラミング、まとめることが好きでモバイル分野で継続的に書籍を出版しています。 内容はおおむね同人誌作りへ適用している技術の話です。 書籍の作り方は出版社によっても違いますが、紹介する内容と同様の作り方をしている商業書籍もたくさんあります。 ここでは著者の目線から出版業界のテクノロジーをのぞいてみましょう。 作る楽しみと読者の視点 著者が本を書く動機は人それぞれですが技術を広めたい、たくさん売れたい、自分の知識をまとめたいなど目的を持って書き始めます。 また一方で書籍の目
日本地質学会が「ブラタモリ」制作チームを表彰へ 「地質学の普及に貢献しているのは明らか」
日本地質学会は、NHK毎週土曜日に放送されている「ブラタモリ」制作チームを表彰することを発表しました。「ブラタモリ」制作チームは2016年にも「測量の日」功労者として国土地理院から表彰を受けていました（関連記事）。 ブラタモリ公式サイトより 「ブラタモリ」はタモリさんが日本全国の街を巡り、その街の自然、産業などの成り立ちを探る旅番組。通常の旅番組とは違い、ショッピングやグルメをほぼ取り上げないのが特徴で、番組ではタモリさんが専門家と共に歴史や地質について語る場面も多く、専門家の出すクイズにタモリさんが簡単に答える場面は見どころの1つ。地質や地理に関する専門的な内容も、ほぼ毎週盛り込まれていました。 日本地質学会は「ブラタモリ」について「地学の普及に関わる学芸員・研究者などが出演して、視聴者の理解を助けている」「タモリ氏の地理・地質好きというキャラクターに負う面も大きいが、訪問地や番組構成、
「箸入れになれ！一休さん！」円周率の覚え方がヤバい電書発見 | アオシマ書店 - 電子書籍の情報サイト -
物理的な制約から解放された電子書籍。可能性が拡がった。 倉庫に作った本が余りまくって決算期を超えるからって断裁して捨てなきゃ、みたいなことがなくなったので、珍品でも出せるようになった。 というわけで、自分でもKDP（Kindleダイレクト・パブリッシング）で『思考ツールとしてのタロット』『あたらしいじゃんけんをつくろう』などの電子書籍を出している米光さんが、電書の凄さを感じさせる「これを読んでみてよ！」っていうモノを紹介するシリーズ「電書の可能性」。 第四弾は高田明弘『パイ文 円周率1,000桁の覚え方』だ。 円周率を１０桁ごとに、語呂合わせで文章にした本である。 タイトルに「覚え方」とあるのに、「はじめに」でいきなり“この本を読んだからと言って、すぐに円周率を覚えられるものではない”と宣言される。 じゃあ、なんでこんな本を作ったのか？ “面白そうだった”から！ この潔さ。 そして、本当に
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
「6＋7＝13」この式を頭の中でどうやって計算してる？
水兵リーベ僕の船の覚え方
サインコサインいつ使うん
落ち込んでいる部下に対処する方法 ―認知行動モデルによるアプローチ
仮面ライダーに出てくる数式が話題 実は本物の物理学 - 日本経済新聞
hatebu.me
