  |
はてなキーワード: ドキュメントとは
スマホにて。
ある程度の長さの文章を読むとき、私は「画面上部1/4くらいまでに表示されている文章」を読む。
その先の文章は、目を動かすのではなく、文章を上げる。”画面内視覚範囲”とでも言うのかな。
なので、よくあるサイトデザインで、上にスワイプする（文章を進める）とヘッダが隠れて、
下にスワイプする（文章を戻す）とヘッダが「ニョキ！」とでてくるアレが見づらい。
少し前の文章を読み返そうと画面内視覚範囲を覆うからだ。あれ、逆か？まぁいいか。
…おわかりいただけるだろうか。
こういう文章の読み方って、脳内の一次バッファが少なすぎて、目を動かすと、目を動かすこと・続き位置を見つける事
に気をとられ、読み終わった部分の記憶が切れて、文章の把握ができなくなる。
もちろん、仕事のドキュメントやメールをスマホで読む時は、集中しているからそんなことはないのだけれど、
スマホで合間の時間を潰すようなものや、何気ないような情報収集をしている時、特にそう思う。
みんなはちゃんと、画面上の文章を目で追いかけているのだろうか。
こんな読み方をするのは、紙の本をあまり読み慣れていないからなんだろうか（紙ってスワイプできないし）。
今はやってないが、昔wordでドキュメント作成した時にはそういうツールっぽいVBAをいくつか用意しておいたことがある。
Excelなんかの印刷時のずれについては経験ある人だと結構うまくやるので、
増田の現場は若いSEが多いんだな。教育コストにも言及してるから。
いや、たとえばドキュメントの途中に章を挿入することになって、以降の章番号を振り直すことになって、それで午前中がつぶれるとか。
自動でやったら一瞬だよね。
方眼Excelだと、行は自分で区切って次の行にするから、用語の変更とかで一括置換すると行の長さがガタガタになったりして揃えるのにまた何時間もかかるとか。
紙に印刷して、それを正だとする現場だと、レビューでセルで切れてる文字がないかとか目で確認とか。
方眼Excelのせいでない部分もあるけど、基本的に方眼Excelを使っているところは徹底的に手作業で書式を整えるって発想だから、書式を簡略化して自動化すれば3割どころじゃない工数の削減が可能だね。
なんと具体的な回答が！
なるほどね。食ってかかるようで申し訳ないが、
それで7割減は大げさでないの？
自分もずいぶん前にドキュメントの作成方法についてはいろいろやってみた。
だから「7割減」に食らいついたんだけど、
例えばjavadocのようにコンテンツの記述のみ行えばよくて
デザイン・レイアウトは決め事という方法をとっても7割減はむりだろ。せいぜい3割減だと思う。
要件定義書やインフラの設計書なんかは書式的に面倒なことは少ないと思われるので、(詳細設計書は自動生成として)
おそらく面倒なのは基本設計書、テスト仕様書と結果報告書だと思うが、
それらにはjavadoc方式(内容と書式の分離)では表現が不足して実用にならないだろう。
書式と内容の分離って書いてあるじゃん。
プレーンテキストでマークアップで文章を書くと自動で書式の整ったドキュメントをだしてくれるとか。
そこまでやらなくても、無意味に罫線を多用するフォーマットをやめて、wordのスタイルで対応できる程度のシンプルな書式にするとか。
科学的には死刑が凶悪犯罪抑止にならないとされてる。個人的には科学が億単位の国民の凶悪犯罪と死刑の関連を証明できる段階にはないとは思ってるけど。
と言っても、科学先生の方が個人的な感想よりはマシなのは間違いないだろう。
ただ、死刑が凶悪犯罪抑止に繋がるように啓蒙して、結果抑止につながる可能性ってのはあるんでないか？日本で、死刑廃止を訴えたって実現の可能性が少ないのは廃止派の人が一番よく分かってると思う。
実現不可能なことを考えるよりも、今ある制度の中で凶悪犯罪抑止の可能性を高めるようや方法を考えるってのはあかんのけ？
【追記】たくさんブクマが付いてたので、気になったのは返信していくぜ
※なんかあんまり伝わってない感じがしたので内容に付いて補足説明
啓蒙っていうのは、死刑があるから日本では凶悪犯罪なんて割にあわんと周知するイメージ。方法はなんでも良い。宗教、映画、言論、死刑のドキュメントなんかでも。これは性犯罪が厳罰化されたから、厳罰を強調して性犯罪がちょっとでも減ったらいいなと一緒だと思ってる。そんなおかしいけ？
id:t-tanaka 個人的には同意。刑罰は被害者の報仇感情の充足ではなく，犯罪の抑止を目的に課されるべきだ。死刑を存続させるのならば，その抑止効果を証明し続け，また高め続けなければならない。
→今のところほぼ唯一の賛成意見。俺が言いたいのはこれ！かしこいひとの言葉は違うな。
id:FTTH 死刑が凶悪犯罪抑止に効果がないことをお前に啓蒙したとして、「なるほど死刑に効果無いですね」って考えに変わることに現実性感じるかね？
→全然変わる可能性はあるな。大麻がドラックだと思ってた時期もあるし。そう思えないのは、本文とトラバ参照。
id:teebeetee 「悪いやつは死んで当然」みたいな浅い正義感が公的機関から肯定的にばらまかれてる社会のほうが、一人ひとりの殺人への抵抗感は薄れるんじゃないか。
→なんでそんな浅い正義感ばら撒くの？凶悪犯罪をしたら死をもって償わなきゃいけなくなるとかでいいんでない？
id:ChieOsanai 広場で処刑を見世物にしてた時代でも凶悪犯罪バンバン起こってたからなぁ
id:IkaMaru 死刑廃止が実現する可能性が低いという理由で、もっと実現性のない提案をする意味がわからない。
→そこまで実現性ないかね。解明はできないだろうけど色々な啓蒙活動が凶悪犯罪を予防してることがありそうだけどな。
id:oka_mailer いやーこれ、啓蒙してでも死刑に意義を持たせたい、存続したい、みたいな話になってるで。
→意義っていうのが、凶悪犯罪の予防効果ってことならその通りやで！存続については、自分の思いとしては死刑の肯定に予防効果あんまり関わってこない。
id:sangping 本来抑止力のない死刑に運用次第で抑止力を発生させることができるなら
→できるってより可能性があるくらいにしか思ってへんな。なんで、死刑を絡めるかはトラバ。
id:kimitama74 なぜそこまでして殺人を肯定する理由を探すのか。殺人が禁忌であることを理解させるには死刑ですら許されないことを教えるべき。
→死刑を殺人を一緒にする部分に違和感。懲役を監禁強制労働と言わないの同じ。あるいは、正当防衛をした人に殺人者と言わないのとも似てる。
id:megazalrock その論理だと死刑になるために凶悪犯罪を起こす人間を助長することになっちゃうよ
→逆に、死刑になると思ってなかったっていう凶悪犯罪を減らすことにもなるかも。どちらもありえそうやね。
わざわざつけなくても文脈でわかるよね。
つけたほうが紛れがないってことなら、
「Raspberry PiとGo言語でミニトマトの栽培環境を監視してLINE Botで通知する」
みたいなのは
「Raspberry Pi端末とGo言語でミニトマトの栽培環境を監視してLINEアプリ Botで通知する」
と書くかというとそんなことは絶対ないし。
－－追加
Goじゃわからないとかつけたほうが優しいみたいな人がいるけど、golang.orgのドキュメントでさえ、golangみたいな書き方しないでGoとしか書いてないよな。
CだってC Languageとか書かないでただCと書くのが普通だし。
ーー追加
TPOとか状況に応じてつけろとかいい加減なこと言ってる人がいる。
常に付けなくていいよ。
明示するときは「プログラミング言語C」みたいに文章の最初に書くよ。あとはC。
English語とか、Japanese語みたいな書き方変でしょ。C言語とかCOBOL言語みたいな書き方おかしい。
イングリッシュ語と書くのが適切な状況ってどういう状況だ。
アングラドキュメント製作に定評があるviceですねw個人的には好きなチャンネルでよく見てます。
大麻を処方してもらいたい患者さんがいるのはその通り。ただ、緩和医療に携わる医師、国、WHO等々あまり大麻の医療的な価値は評価されていないというのが現状のようですよ。http://ameblo.jp/setakan/entry-12213096331.html
WEB始まりすぎだし、アプリもゲームも始まりすぎなんですけどって話
WEBに関してはruby/railsとかは900万超えの求人出しても来てくれないくらいには好調です
HTML/CSS/JS/Railsができて仕事ないとか言ってる人いたら教えてほしいくらいだよ
俺の会社他にアプリ部門があるんだけどもっと人が足りないって愚痴ってるしこのままだと1000万行くかもしれない、うらやましいくらいの話だ
まぁ結局はてなも２ｃｈもそうなんだけど、ネットで愚痴ってるやつって仕事できない無能が８割か、転職怖い昇給交渉怖いって動こうとしないビビリのクズか
それか若者つぶそうとして楽しんでるやつか、なにかしらの病気なので相手にしないほうがいい
進化が早すぎてついていくのがつらいよーってやつの話にも聞かないほうがいい
追加された機能をゴリゴリ生かさなければいけないなんてシーン俺は知らない
まぁ大きく変わったのはFLASHが廃れて」、HTML5/JSで代替しなければいけなかったことくらいだけど
べつにそれに関しても大した話じゃない。ゆっくり以降していった話
フロントエンドはつらいなんて話をよくしてる連中いるけど、ただの馬鹿がファッションで乗って、つらさを自慢しあってるだけ
あいつらがやってることの9割は必要ないことで苦労してると思うわ
gulp/grantなんかのタスクランナーとかする必要ないのにして変化が激しいとか愚痴ってる意味の分からない
anguler/ract/vueあたりもな
SPAなんて特殊なものをこれから来る必須技術みたいにさわいで技術飛びついて変化が激しいって騒いでスターもらいたがってるだけ
結局ブログで承認欲求みたすための苦労自慢でリスカ女と変わらないので相手にする必要なし
railsは変化が速いのでは？なんて話も真に受けるな
たしかに3くらいまでは俺自身が慣れてなかったからつらかったといえばつらかったが、その程度の変化ほかの業界でもいくらでもある
なによりネットにドキュメントが大量にある、はっきり言ってほかの産業にくらべて勉強が楽なくらいだ（ググるときに注意が必要だけど、情報の鮮度とか正確性とか）
railsはフレームワークが1強なので迷わなくていいし仲間も多いから、かりに変化がおこっても、頭のいい人がドキュメント残してくれるし、勉強で困ったことなんかほぼない
5.1でjquery依存をなくすとか、CoffeeScript廃止とか、yarn採用も困らなかった
もう一度言う
プログラマーになりたいと思ってる君、情報工学部（コンピューターサイエンスやる学部ね）行こうね、私は大学で電気科に言ったんだけどいまだに後悔してる
プログラマーなんかIT土方だしとか言われてて電気か機械のほうがいいといわれて私は電気を選んだんだよ
水泳の前のラジオ体操のように、ファイル操作を最初に必ずやるそうな
「はい、ではデスクトップの真ん中にあるファイルを、お好きな名前に変更してみましょう」
「変更できましたか？ではそのファイルをマイドキュメントにコピーしてみましょう」
「コピーできましたか？ではデスクトップにある方のファイルを削除しちゃいましょう」
「マイドキュメントの方のファイル、名前の頭に『A』と書き加えてみましょう」
「デスクトップにある『画像』という名前のフォルダの中で、最も古い写真はいつ頃撮られたものか、調べてみましょう」
こんな感じのやつを毎回これを30分くらいかけてやるんだと
一年くらい根気よく通ってる人になると、
「先月中旬に保存したワードファイルの中で、『拝啓』を『背景』と打ち間違えてしまったものがあります。どこのフォルダのどんな名前だったのかか忘れてしまいました。どうにか探し出して訂正しましょう」
これが数分で出来るようになるらしい
もし素人物AVが無かったら僕の人生はずいぶん味気ないものになっていただろう。
素人物AVには複数の女優が登場する。当たりもあれば外れもある。そこがいい。素人物AVは人生に似ている。
いや、むしろ人生そのものが壮大な素人物AVなのかもしれない。僕は本気でそんな風に考えてる。
たまに叫びだしたくなる。
その日は６時から漁り始め、すでに７時間が経過していた。僕は少し空腹を感じ始めていた。そういえばまだ何も食べていないことに気付いた。
とりあえず一本ダウンロード購入することにした。 食事は作品を鑑賞してからにしよう。
見終わった。
恋。
僕は恋に落ちてしまった。
完全に一目惚れだった。
この作品には５人の女優が出演している。そのうちのひとり、某エクササイズスクール講師(20歳)に僕の心は激しく揺さぶられた。こんな気持ち、初めてだ。
大抵の人は知ってると思うけど、素人物AVというのはほぼヤラセだ。本当の素人が出演していることなんてまずないといっていい。
僕はその点については何の不満もない。むしろその方が良いとさえ思う。求めているのはリアルではなく、あくまでリアリティなんだ。
大抵の素人物AVの出演者は、数多くの作品に出演している。中には単体作品にも出て人気を博している女優もいたりする。
好みの女優を見つけたら、当然他の作品も見たくなる。そうなった時は女優を特定する作業に入る。ここまでが僕ら素人物AV愛好家のルーティンワークなんだ。
安心して欲しい。女優を特定するのはそう難しいことじゃない。今はそのためのデータベースサイトがいくつもあるんだ。
僕らはほんの些細な情報の断片からでも女優を特定することができる。その能力はCIAと比較されることも多い。
僕はすぐに特定作業に入った。ちなみにこの「人間観察ドキュメント」シリーズは系列レーベルの「人間観察ドキュメントQ＆A」シリーズと混同しやすいから注意が必要だ。
調査の結果が出た。出演者は５人。僕は女優名の欄を順番に確認していった。
「宮下真衣」
「華野梓」
3.某ウォーキングスクール講師
「前田由美」
「堤まほ」
ここまでは順調だ。そしてついに５人目。僕が恋に落ちた彼女。
「 」
ええええええええええええええええ？？！
こんなこと初めてだ。ひとりだけ空欄なんて。
それから色々と手を尽くした。ネット検索はキーボードが粉々に砕けるまでやった。
レーベルにも問い合わせた。同系列の作品を片端から見まくって彼女の消息を探った。全国のDVDショップを探し回った。飛行機にも乗った。台湾や韓国にも飛んだ。
でも彼女は見つからなかった。僕はどしゃ降りの雨の中で獣のように泣いた。
僕は「某エクササイズスクール講師」としての彼女しか知らない。時間にして約40分。それ以外の彼女を永遠に見ることが出来ない。永遠に。
その古いデータを最新バージョンのライブラリを使ったアプリで利用したいと言われて作業していた。
しかし、どういうわけかそのデータを読み込みが上手く行かずに試行錯誤していた。
上司もドキュメントをちょこちょこ読んでボンヤリとは概要を分かっているようだった。
そして、自分はどうやらデータが使えないらしい原因を発見した。
ライブラリの最新バージョンで追加されたメソッドを使って情報を取得すると、
古いデータはシステムでは読み込めない形式になっているというのだ。
ただ、この結果は少しおかしい。
システムで読み込めない形式ならば古いバージョンでも使えないはずなのだ。
この結果は矛盾している。
このデータはシステムで読み込めない形式だとエラーが出ていると。
上司は一笑に付した。
「ありえない。それはメソッドの使い方が悪い。データの読み込ませ方が悪い」
そう言ってまったく相手にされなかった。
自分は軽く見られているのだろう。
軽んじられているのだろう。
結果は矛盾しているが、一考し何かしらの検証をして見る価値はあるし、
虚しくなってしまった。
そこまで信用していないなら全部自分でやればいい。
英語がつらい。
やっぱり辛い。
たぶん幼稚園の英語でなんかやってたみたい+中高6年間+浪人自体の英語特訓+大学の英語+趣味や業務での英語学習.....ずっとやってきたけどつらい。
英語を読むのが辛い。俺は理系なんだが、文法の問題とか、すごく得意で、毎回高得点を取れるので、英文法はできると思うんだが、単語が覚えられない。いや、中学高校の単語帳に乗ってるようなものは覚えてるよ。けど、英語でさ、技術系の論文読むときに、わけわからない単語が出てくるんだわ。そのさ、その時に辞書引くじゃん? 今は、んでさ、調べている間に、読んでた内容がすっとんじゃうわけ。
もっとつらいのは、知ってる単語、その文の主語とか文法は分かるんだけど、その一文の意味がさっぱり分からない時があって、それもつらい。その時ってのは、その文自体が、なんか特別な言い回しだったりするわけ。まんま、なんか流行ってる言い回しなら調べたら解決する場合があるから、良いけど、ちょっと捻ってるのわからない。どうすりゃいいんだ。
もっとつらいのは、英語の聞くときだ。本当にわからない。いろんな方法を試したんだけど、ほんとうにダメ。無理。ほら、TEDやら5分のニュースあるだろ?あれ、僕全然持たないんよ。その最初は、頭の中で、英語の文をつくる感じになるじゃん? そして、日本語にすんの。なんというか、英語の音=>英文=>日本文=>意味みたいな流れをずっとやってるわけじゃん? あれできるやつどうやってんの? 大分負荷が高いよね? 1分ぐらいで頭が沸騰するんだよ。
いや、もうだめ。英語。ほんとダメ。同僚はすごくできるのに。いくら、日本語で書かれた難しい技術が理解できたってダメだと思うんだけど、もうね、ダメだと思う。
「型システム入門」「分散システム」「On Lisp」「ガウディ本」「メイヤーのオブジェクト指向入門本」....いろいろ日本語の本であるならば、全然読めるんだよ。けど、英語が読めねぇんだよ。
なんで、こんなに英語がダメダメでも、いろんなライブラリ使えてきたかって、実装を読めば分かるじゃん。英語のドキュメントは読めないけど、コードを読めば、どう動くか分かるじゃん。だから、なんとなってるけど、限界を感じてきたんだよ。なぜかって、仕様なのかバグなのか分からないんだよ.......だから、英語の仕様読むしかないんだけど.....本当につらい。
「やあ。実はね、今日はお別れを言わなきゃと思って」
彼は隣に腰掛けて、僕はそう言った。
僕はいつも、彼に会うとそう言うのだ。
「ギムレットを。」
彼は僕の言葉を無視して、バーテンダーに注文した。彼はいつも、最初の一杯目はギムレットだ。たとえ無言で店に入ったとしても、バーテンダーはライム・ジュースとジンを用意するだろう。
「そうか、僕もさよならを言うべきだと考えてたよ」
彼は芝居のかけらもない、抑揚のない口調でそう応えた。
僕らにとって、これらのやり取りは一風変わった挨拶のようなものなのだ。はたから見れば、同性愛者たちの深いドラマのある会話のように見えるかもしれない。
彼は紺色のスーツに、水色のシャツを着ていた。ネクタイの深い赤色が冴える。古めかしい黒縁の眼鏡と短い髪は、ビル・エヴァンスのような風貌に見えた。
彼にギムレットが手渡されると、僕らはいつも通り、静かに乾杯をした。
バーテンダーに「適当に作って」と注文したカクテルは、回を重ねるごとに本当に適当になっていた。今日のはミントを感じる以外の味はよくわからない。僕の舌がおかしくなっているのかもしれないけれど。
僕らは他愛のない話をした。本当に、中高生が教室で話すようなことよりも、ずっと他愛のない話だ。音楽のことや、最近見たアクション映画の話や、女の子の話。そして、将来のこと。
僕はオールドグラスを置き、呼吸のついでのようにつぶやいた。
「君には教えてもらったことがたくさんある」
『たとえば？』
「夜の楽しみ方や、大人たちとの話し方。音楽や映画の美しさ。ひとりであっても、素敵な時間を過ごせること。そして、僕にも創作の才能のようなものがあること。もちろん、最後のは思い込みだろうけどね」
『そんなこと、教えた覚えはないな』
「そうかもね。教わった覚えも、実はないんだ」
彼は、のどの奥だけで笑った。
店内はジャズが流れていた。「JUST FRIENDS」であることは確かだが、誰の演奏かはわからなかった。
「やりたいことが、少しずつ増えてきたんだ。途方のない夢じゃなくて、もっと具体的で、実益のある夢だ。」
『実益のある夢』
「そう。砂漠を掘って石油王になるとか、そういう夢じゃあなくてね」
「ああ。スコップを持って、砂漠の砂を一匙ずつすくうんだ。そういう作業を、これからしなくちゃあならない」
『その通りさ。結局は、何かしらの積み重ねだよ。すべてはね。明日から急に天才になれたり、金持ちになれるとか、しがらみから解放されるっていうのは、危険なプロバガンダでしか存在しないんだ。』
僕は、グラスの中身を3/4ほど残して言った。
「僕はもう帰ろうと思う」
『でもね、もし君と、本当にずっと、永遠に会えなくても、僕はここで待っているよ。ホラー映画のセリフみたいに聴こえるかもしれないけどね。』
『ジョン・レノンのスターティング・オーヴァー、君も好きだろ？ 「これも素敵な"再開"のための別れなんだ」って、そう思うんだよ。だから、ずっとここで待ってる。いつでも、ここに来てもいいんだ』
『君がここに来ることは罪じゃあない。言うまでもなく、無罪でもない。有罪でもない。難しいところなんだ。君自身は悪いことだと感じていても、現実的には無罪なんだ。』
僕は何も言わずに席を立った。
隣にずっといたはずの紺色のスーツと赤いネクタイの男なんて、まるで最初からいなかったかのように、なにもないカウンターチェアが、かすかに回っているような気がした。
○朝食：ヨーグルト
○夕食：ご飯、納豆（二つ）、ツナ缶、減塩野菜たっぷり味噌汁（フリーズドライ）
○調子
はややー。
仕事はやることがなくて、ドキュメントの誤字脱字チェックとか、そういう何でもないことをしていた。
なんかもう三時ぐらいからはあまりにも暇すぎて、頭のなかで今日のポケモンダイレクトのハードルをいかに下げられるかということばかり考えてた。
ちなみに、僕の開始前の予想は、
本命：ポケダン空iOS移植、対抗；ポケランドオープンベータ、穴：ポケモンGO大型アップデートでサンムーンに送ると夢特性3V、大穴：ポケとるパッケージ版
ぶっちゃけ、明日もやることないんだけど、どうしたもんかなあ。
いつかはスイッチも買いたいけど、このタイミングではないかなあ、来週にはスコルピオの発表もあるだろうし。
それから、サンとムーンのマイナーチェンジ、ウルトラサンとウルトラムーンが公開。
マイチェンは久しぶりだね、XYのときになかったし、BWのときは続編だったから。
とはいえ、B2W2のような二本同時発売でもあるから、続編なのかマイチェンなのかまだよくわからない感じ。。
ただ続編ではないのかな？ ぶっちゃけ、リーリエとお別れのショックが未だに自分の中で重みになってるせいで、本編で育成や対戦をできてないので、続編でリーリエとの物語を綺麗に終わらせて欲しくもあったり。
あれ？ クリスタルは？ とは一瞬思ったけど、とりあえずこれでポケモンバンクを通じて全世代のポケモンが集まれるようになったのは凄いと思う。
前に何かで書いたけど、金銀の頃は中学受験の真っ最中だったから、あんまりプレイできてなくて、HGSSの方が思い入れが強いんだけど、これを機にプレイするのも良さそう。
ポケモン熱アッーーープ！
そろそろサンムーンでのメガストーンも解禁されてきているし、本腰を入れ出そうかな。
よーし、色々遊ぶぞー！
●XboxOne
最近、ハースストーンとかシャドーバースとかで流行のデジタルTCG。
ハースストーンはやりたかったんだけど、iPadminiだと頻繁におちるし、iPhoneは容量がいっぱいだからできないでいたので、
とりあえず、チュートリアルをこなして、今はリーダー（MTGでいう色みたいな感じかな？）を解放するために一人用モードを遊んでいる。
今日は、
北方諸国を全ステージ、スコイア＝テルを全ステージ、スケリッジを半分クリアした。
場に出た時に、三枚ドローして三枚戻す効果で、手札の質が非常によくなる。
しかも、このマリガン能力でダメージが誘発するモンスターもいるので、超いい感じ。
3ラウンド制で、1ラウンド終わるごとに場はリセットされるんだけど、この継戦能力持ちはリセットされない。
なので、とにかく継戦持ちを強化して強化して、一気に2ラウンドとる戦法が楽しい。
もちろん、この戦法にも弱点があって、ダメージとか関係なく最大戦闘力持ちを除去するカードを使われると、相当しんどい。
サブの勝ち筋も必要な感じかなあ。
●3DS
○ポケとる
とはいえ、捕獲はまだ三匹とも出来ていないので、頑張るぞいや。
○はねろコイキング
コイキングは、25代目。
