わかりやすいドキュメントを書くには 〜 全体像を把握できることが重要 - Qiita
はじめに エンジニアなら誰でもたくさんのドキュメントを読むことになります。 その中にはわかりにくいドキュメントも少なからずあると思います。 自分はわかりにくいドキュメントは「全体像が掴みにくい」ことが多いと感じています。 そこで、ここではわかりやすいドキュメントを書くための方法を「全体像を把握できるようにする」という視点でまとめてみました。 また、最後に具体例としてQiita APIドキュメントでわかりにくい点の指摘と改善をしてみました。 ここで扱うドキュメントの種類 ここでは仕様書やリファレンスマニュアルといった類のドキュメントを想定しています。 Qiitaの投稿やブログの記事といったものでも共通する部分は多いのですが、これらには他にも重要な要素があると思うので、ここでは扱いません。 わかりにくいドキュメント=全体像が掴めないものが多い 先ず、わかりにくいドキュメントとはどんなものでしょ
まさかブコメを書いて世の中が良くなるなんて思っていないだろうな
話題になった記事にははてブが付く。 やれ「こうしたほうがいい」だの「この考えは間違っている」だの、あらゆる角度から精査吟味したコメントが山ほど付く。 こういうコメントを日常的に付けている「お前」に聞きたい。 なぜ、はてブでコメントを書いているのか。 「自分が気持ちよくなるために決まってんだろカス」 返ってくるのがこんな回答なら自分は満足だ。 「なぜオナニーするのか？」と訊かれたときと同じなら何も文句はない。 しかし、「お前」はそうは答えない。「間違っていることを間違っていると指摘するのは当然…」みたいな、ゴニョゴニョしたことを言う。 世の中の間違いを正し、正しい考え方を伝えたいなら、なぜはてなブックマークのコメント機能なんか使う？ まさかそれが自分の意見を伝える最適な手段だと思っているのか？ はてなブックマーカーのxevraという人はこんなコメントを書いている。 「棘があるのはそうしないと
容量無制限のAmazon Drive Unlimited ストレージが超使える【重要な追記あり】 | HappyMac はっぴーまっく
ボクがAmazon Cloud DriveのUnlimited ストレージを導入した理由 どうも、リョウサトウ（@ryosatony）です！2016年7月20日よりクラウドドライブAmazon Cloud Driveの容量無制限プラン「Unlimited ストレージ」が日本でも始まりました。アメリカのAmazon Cloud Drive Unlimited Everything Planの日本版です。価格は13,800円（1年間）、3ヶ月無料体験ができます。 参考 容量無制限のオンラインストレージ、Amazonが日本で開始 年額1万3800円 – ITmedia ニュース 日本で始まったことを受けてAmazon Driveについていろいろ調べ、これはかなり有効な印象だったので本格的に利用し始めました。容量無制限の割に安く、コスパが高そうと踏んだのです。 最近スマホで写真はもちろん、動画を高
高畑裕太氏釈放、弁護人のコメント全文：朝日新聞デジタル
強姦（ごうかん）致傷容疑で逮捕、送検されていた俳優の高畑裕太氏（２２）＝東京都渋谷区＝が９日午後、群馬県警前橋署から釈放されたことを受け、高畑氏の弁護人がコメントを発表した。 全文は、以下の通り。 ◇ 今回、高畑裕太さんが不起訴・釈放となりました。 これには、被害者とされた女性との示談成立が考慮されたことは事実と思います。しかし、ご存じのとおり、強姦致傷罪は被害者の告訴がなくても起訴できる重大犯罪であり、悪質性が低いとか、犯罪の成立が疑わしいなどの事情がない限り、起訴は免れません。お金を払えば勘弁してもらえるなどという簡単なものではありません。 一般論として、当初は、合意のもとに性行為が始まっても、強姦になる場合があります。すなわち、途中で、女性の方が拒否した場合に、その後の態様によっては強姦罪になる場合もあります。 このような場合には、男性の方に、女性の拒否の意思が伝わったかどうかという
SoftBankショップでiPhoneを修理に持ち込んだら偽物扱いされた話
りんご @ringo8726 たくさんのリツイートや応援リプありがとうございます。頑張ります ソフトバンクは誠意のある対応はしないという社内方針なのでしょうか（笑） ソフトバンクユーザーの方、変更を検討されている方はお気をつけください。 2016-09-09 16:52:04 いっちー@嫁袋 @kim215ichi (嫁)<元携帯販売員として言わせてもらいます。 修理に持ち込んだ店の対応がアップルの認定取り消しレベル並みに酷い IMEIなどの情報は全て正規品であることの証明となるため、明らかに店側の怠慢 店側で情報共有しても同じ事が絶対起こる twitter.com/ringo8726/stat… 2016-09-09 15:42:16
高畑裕太 顧問弁護士がコメント発表「悪質な事件ではなかった」 - スポニチ Sponichi Annex 芸能
高畑裕太 顧問弁護士がコメント発表「悪質な事件ではなかった」
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
