わかりやすいドキュメントを書くには 〜 全体像を把握できることが重要 - Qiita
はじめに エンジニアなら誰でもたくさんのドキュメントを読むことになります。 その中にはわかりにくいドキュメントも少なからずあると思います。 自分はわかりにくいドキュメントは「全体像が掴みにくい」ことが多いと感じています。 そこで、ここではわかりやすいドキュメントを書くための方法を「全体像を把握できるようにする」という視点でまとめてみました。 また、最後に具体例としてQiita APIドキュメントでわかりにくい点の指摘と改善をしてみました。 ここで扱うドキュメントの種類 ここでは仕様書やリファレンスマニュアルといった類のドキュメントを想定しています。 Qiitaの投稿やブログの記事といったものでも共通する部分は多いのですが、これらには他にも重要な要素があると思うので、ここでは扱いません。 わかりにくいドキュメント=全体像が掴めないものが多い 先ず、わかりにくいドキュメントとはどんなものでしょ
公の場での自慰行為は無罪、未成年者いない限り 伊最高裁：CNN
（ＣＮＮ） イタリアの最高裁判所は１０日までに、公の場での性的な自慰行為は未成年者が面前にいない限り、犯罪ではないとの判決を下した。 同国南部シチリア島のカターニア市で６９歳男性がこの種の行為で逮捕され、最高裁に控訴したことを受けた判断。未成年者がいない公の場所での自慰行為は、昨年修正された刑事法でもはや刑罰の対象にならないとの規定を踏まえたもの。 未成年者の面前で犯した場合は、最大で禁錮４年６カ月の処罰となっている。 最高裁の法廷文書によると、男性は昨年５月、カターニア大学のキャンパス内で学生を前にしてオナニーを行って逮捕され、禁錮３カ月と罰金３２００ユーロの有罪判決を受けていた。 男性の弁護士がその後、最高裁に控訴し、判決は今年６月に出されていたが、その内容は最近になって初めて明らかになっていた。 最高裁による今回の判断を受け、男性の審理はカターニアの地方裁判所に差し戻され、焦点は行政
「自発ください」「お迎え」「らぶりつ」に見る10代の危険性
Twitterでは以前から、10代の間で独特のネット用語が流行っている。例を挙げていくと次のようなものだ。 「＃自発ください」 「＃らぶりつ」 「＃（RTした人で気になった人）お迎え行きます」 「RT中心に巡回します」 このあたりの単語を実際に使っていたら、そのほとんどが10代、中学生や高校生などだ。どれも、Twitter上で絡んでほしいという意味を指す言葉ばかりだ。 今回はそのような10代における流行のネット用語から、彼らの心理と行動パターン、問題点を見ていきたい。 「自発ください」「らぶりつ」に見る高校生の心理とは 「自発ください」とは、“自分から発信する”の略。使われ方によって若干意味は変わるようで、たとえば「自発くださいフォロバします」という場合は、「（自分から）フォローしてください。フォローバックします」を意味する。 可愛く撮れた自撮り写真に「＃自発ください」というハッシュタグが
React Fiberアーキテクチャについて | POSTD
初めに React Fiberは、現在進行形で進められているReactのコアアルゴリズムの再実装であり、Reactチームの2年以上にわたる研究の成果です。 React Fiberは、アニメーション、レイアウト、ジェスチャーといった領域に対する適性を向上させることを目指しています。React Fiberの目玉となる インクリメンタルレンダリング は、レンダリング作業を分割して、複数のフレームに分散させることができる機能です。 他には主に、新たな更新があった際に作業を休止・強制終了・再利用できる機能、更新の種類別に優先順位をつけられる機能、新しい並行プリミティブなどが挙げられます。 このドキュメントについて Fiberは、コードを見ただけでは分かりにくい斬新な概念をいくつも導入します。このドキュメントはそもそも、ReactプロジェクトにおけるFiberの実装に伴って私が取っていたメモを集めたも
女子更衣室に盗撮スマホを発見→男性教諭「俺に任せろ」「学校を守りたい」などと叫びスマホを破壊 : 痛いニュース(ﾉ∀`)
女子更衣室に盗撮スマホを発見→男性教諭「俺に任せろ」「学校を守りたい」などと叫びスマホを破壊 1 名前： アイアンクロー(catv?)＠＼(^o^)／：2016/09/10(土) 00:45:43.25 ID:RTfdHREi0.net 埼玉県警春日部署は９日、勤務先の中学校でプールの女子更衣室に侵入したとして、建造物侵入の疑いで同県蓮田市の中学校教諭（５２）を逮捕した。更衣室に置かれた穴の開いた段ボールの中からスマートフォンが見つかっており「盗撮するために入った」と容疑を認めている。 逮捕容疑は、８月下旬から９月８日午前までの間、春日部市立葛飾中屋外プールの女子更衣室に侵入した疑い。 同校によると、容疑者は保健体育の担当で、生徒指導主任。８日午前に授業で更衣室を使った女子生徒がスマートフォンを見つけ、女性教諭に報告した。女性教諭が容疑者を含む同僚に相談したところ、容疑者は「俺に任せろ」「
ゼロから作るDeep Learning
ディープラーニングの本格的な入門書。外部のライブラリに頼らずに、Python 3によってゼロからディープラーニングを作ることで、ディープラーニングの原理を楽しく学びます。ディープラーニングやニューラルネットワークの基礎だけでなく、誤差逆伝播法や畳み込みニューラルネットワークなども実装レベルで理解できます。ハイパーパラメータの決め方や重みの初期値といった実践的なテクニック、Batch NormalizationやDropout、Adamといった最近のトレンド、自動運転や画像生成、強化学習などの応用例、さらには、なぜディープラーニングは優れているのか？ なぜ層を深くすると認識精度がよくなるのか？ といった“Why”に関する問題も取り上げます。 関連ファイル サンプルコード 正誤表 ここで紹介する正誤表には、書籍発行後に気づいた誤植や更新された情報を掲載しています。以下のリストに記載の年月は、正
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
ボケはそんなに重要か - 日経トレンディネット