わかりやすいドキュメントを書くには 〜 全体像を把握できることが重要 - Qiita
はじめに エンジニアなら誰でもたくさんのドキュメントを読むことになります。 その中にはわかりにくいドキュメントも少なからずあると思います。 自分はわかりにくいドキュメントは「全体像が掴みにくい」ことが多いと感じています。 そこで、ここではわかりやすいドキュメントを書くための方法を「全体像を把握できるようにする」という視点でまとめてみました。 また、最後に具体例としてQiita APIドキュメントでわかりにくい点の指摘と改善をしてみました。 ここで扱うドキュメントの種類 ここでは仕様書やリファレンスマニュアルといった類のドキュメントを想定しています。 Qiitaの投稿やブログの記事といったものでも共通する部分は多いのですが、これらには他にも重要な要素があると思うので、ここでは扱いません。 わかりにくいドキュメント=全体像が掴めないものが多い 先ず、わかりにくいドキュメントとはどんなものでしょ
Google Search Console（サーチコンソール）を強力なSEOツールとして使うための究極ガイド。 - SEO Japan｜アイオイクスのSEO・CV改善・Webサイト集客情報ブログ
今、あなたが読み進めているこの記事は、GSCにおける、大学卒と言えるレベルの内容を記載している。ここでの内容をマスターすれば、あなたはGSCニンジャとなることができるだろう。 そして、それはあなたのSEOに非常に大きな違いを生むこととなるはずだ。 まずはこの記事の概略を説明したい。非常に長い記事となっているため、キリの良いところで区切って読みたいと感じるだろう。 この記事はセクションとサブセクションに分かれているが、この分け方は、GSCのメニューに基づいている。 *元記事では英語画面のキャプチャですが、日本語画面のキャプチャに差し替えています。 上記のセクションの内、始めの4つのセクションに注力している。つまり、パートAからパートDまでである。パートEとパートFも重要ではあるが、あまり説明を必要としないものだからだ。 パート A：検索での見え方 検索での見え方のセクションは、あなたのWeb
回帰分析②：線形回帰が使えないときに用いる高度な回帰分析方法
生物統計を学んでいる人の中には、「結果変数が連続変数の時には線形回帰、二項変数（0と1など2つの値しか取らないもの）のときにはロジスティック回帰分析を使うべき」のように1対1対応のお作法のような形で教わった人も多いと思います。一方で、計量経済学で回帰分析を習った人の中には、「最小二乗法（Ordinary Least Square; OLS, 線形回帰）はありとあらゆる場合に使えるベストな方法であるので、結果となる変数の分布に拘わらずOLSを使える」（ちなみに結果変数が二項変数のときにOLSを用いることをLinear probability modelと呼びます）と教わった人もいるでしょう。初心者向けの統計学や計量経済学の本を読むとこのような説明がされているものが多い印象があります。このような教え方をすれば確かに手っ取り早く手が動かせるようになる（統計解析ソフトウェアを使って解析がはじめられ
催眠商法（SF商法）潜入ルポ - ひとなぐりこけし
昨日12時50分、京■大学近くの某シェアハウスに到着。13時、メ■ーマー■潜入部隊が集合した。作戦は15分後、■都大学から歩いて数分のところに2ヵ月限定で店舗を構える「■リー■■ト」にて決行。ここで行われているのはいわゆる「催眠商法」「SF商法」で、要は来場者プレゼントなどの餌によっておびき寄せた老人・主婦らを心理学的な手法で洗脳し、購買意欲が異常に高まった段階で高価な商品を売りつける悪質な手口だ。 detail.chiebukuro.yahoo.co.jp 企業名をググってもあまり多くの情報はヒットしないが、2005年にヤフー知恵袋で被害が報告されているのを確認することができる。2ちゃんねるでもたまに言及されるらしい。労働環境が粗悪、脱税が発覚したなんて噂もある。当日0時過ぎにメリ■■■トツアーのことを知ったが、こんなに面白いオモチャもなかなかないのですぐに同行を決めた。 受付で米1kg
kibana4の使い方 - Qiita
2016年3月末現在、AWS ElasticsearchServiceで提供されているkibana(4.0.3)の大まかな使い方をまとめます。 簡単な手順は、 1. Settingsでインデックスの作成 2. Discoverで各インデックスのビューの作成 3. Dashboardで複数のログを見るためのまとまりを作る となる ◆Settingsでインデックスの作成 Elasticsearchに貯められているログのインデックスを作成する場所。 基本的に"logstash-*"形式でkibanaに渡ってくるので、インデックスの形は"log-2016.03.31"や"log_log-2016.04.01"のように という形になっている。 kibanaでログを見るためには、Settingsタブで必要なインデックスを作成する必要がある。 例えば、ElasticsearchServiceコンソールの
fluentdからElasticsearchに書き込んだ際の運用メモ - wyukawa's diary
fluentdからfluent-plugin-elasticsearchを使ってElasticsearchに書き込む部分でたびたびfluentdが詰まって苦労してたけど最近は落ち着いてきたのでその辺を備忘録としてメモっています。 最初はfluentdからElasticsearchに1プロセスで直接書き込んでいたけどなにかのイベント等でトラフィックがはねるとバッファ溢れがおきてました。なおこのときElasticsearch自体は特に問題は起きていません。 num_threads増やしたりbuffer_chunk_limit, buffer_queue_limit, flush_intervalあたりを調整したりというのをやっていたけど（実際にやったのは僕じゃないけど）、それでも厳しいのでプロセス分離してfluentd A -> fluentd B1,B2 -> Elasticsearchとい
個人的に最強のPaaSプラットフォームGoogle App Engineの良い所を挙げてみる - Qiita
2019.12.27追記 この記事は4年前に書いたものをメンテしていて、これまでたくさん読まれたようですが、平成時代のものだと思えてきました。最近、アプリのバックエンドに使い始めたFirebaseのほうが今の時代にあったPaaSだと思います。Google App Engineは2nd generationからはIaaSよりになっていると思うので、高速に開発することを求めるPaaSならFirebaseでしょうということで、この記事は飛ばしてFirebaseの紹介記事を適宜探してお読みください。 クラウドブームの初期にはそこそこ存在感のあったGoogle App Engine（GAE）ですが、PaaSの不人気というか、本格的なクラウド時代が到来してAmazon Web Services に代表されるIaaSの前にすっかり影が薄くなっています。 当のGoogle自体も明らかにIaaSサービスのC
ペアプログラミングして気がついた新人プログラマの成長を阻害する悪習
最近、あまりプログラミングが得意でない人のサポートをする形で、長い時間にわたってペアプログラミングを行っている。そのなかで、気がついた悪い習慣と成長するための良い習慣というものをまとめてみる。 この記事のバックグラウンドとなる体系的知識が本になりました。 エンジニアリング組織論への招待 ～不確実性に向き合う思考と組織のリファクタリング あわせて読みたい 経営者マインドが足りない！vs. 現場に任せてくれない！の対立をなくすカードゲームをつくった話 新人プログラマに知ってもらいたいメソッドを読みやすく維持するいくつかの原則 新人プログラマに知っておいてもらいたい人類がオブジェクト指向を手に入れるまでの軌跡 ペアプログラミングして気がついた新人プログラマの成長を阻害する悪習 あきらめるにはまだ早い！ソースコードの品質向上に効果的なアプローチ 心理的安全性ガイドライン（あるいは権威勾配に関する一
不安とストレスから解放される見積りとスケジュール方法 - Qiita
エンジニア組織を強くするための本を出版しました Qiitaでエンジニアリングをめぐる様々なコミュニケーションの問題とその解決策や考え方を書いてきた。それらの背後にあるエッセンスをこの度書籍として出版するに至りました。 エンジニアリング組織論への招待 ～不確実性に向き合う思考と組織のリファクタリング この書籍は、エンジニアリングを「不確実性を削減する」という第一原理で捉え直し、様々なエンジニアリングとその間のコミュニケーションをめぐる現象を説明していくものです。 はじめに 何かはじめてのことをする場合、人はとても「不安」を感じます。人は未来を考えることができる生き物です。その特異な能力ゆえに、未来に起こるかもしれないよくないことを考えると「不安」を感じてしまうのです。 仕事のプロジェクトなどは、「間に合わなかったらどうしよう」とか「この仕事はちゃんと終えられるのだろうか。」など、未来のことを
【筋トレダイエット決定版】最高に効率よく筋肉を増やし、体脂肪を燃やすトレーニング＆栄養摂取を総まとめ - Freiheit
2016 - 09 - 08 【筋トレダイエット決定版】最高に効率よく筋肉を増やし、体脂肪を燃やすトレーニング＆栄養摂取を総まとめ ボディメイク Twitter Google Pocket スポンサーリンク ネット上には沢山のダイエット情報が溢れているが、疑問が残るものが多い。〇〇だけダイエットなど健康的に偏ったもの、〇〇日で〇〇kg痩せた！！と短期間で結果が出たという謳い文句。なにより、それらの多くは「楽」をアピールしている。 楽をして体脂肪を増やし、太ったというのに楽をして痩せようなんて都合のいい話はない。ただ、効率の良いダイエット、ボディメイクの方法というのは存在する。楽な方法ではない。その代わり確実に結果が出る方法だ。もちろん、継続できるかはその人の意志次第であることは言うまでもない。 長いので目次を用意しました。 オススメのダイエット方法は筋トレ+食事制限 有酸素運動は時間効率
Facebookが公開した10億語を数分で学習するfastTextで一体何ができるのか
fastTextとは何なのか 自然言語処理の学習を高速化するツール これまで５日かかっていたタスクがたったの１０秒で終了 fastTextで取り組める３つのこと fastTextで出来る３つの全体像 Facebookはニュースフィードから釣り見出しを排除するためにfastTextをつくった？ リクルートテクノロジーズでは、レコメンドに応用 サイバーエージェントが実用化したAWAでのアーティストレコメンド Yahoo!はレシートメールの文章から製品をオススメする ◯2Vecを考えれば推薦に応用できる fastTextを安全に使うために必要な理論 単語をベクトル表現化するWord2Vec ベクトル表現を構築するアーキテクチャ CBoW Skip-gram fastTextを使ってみよう fastTextをインストールする 単語のベクトル表現を構築しよう Tweetデータの収集 単語のベクトル表
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
Chefで始めるWindows Server構築
Microsoft AI Cloud Partner Program - Microsoft Partner blog
Python とデータ分析コンテストの実践