  |
はてなキーワード: Wipとは
エンジニア向けの社内ドキュメント共有サービスである、https://esa.io/ を、義務教育で作文を習ったかあやしいやつらが使うとどうなるか事実を書く。
問題点：
1. Markdown が使え無い
4. WIPとShipItを使い分けることができない
6. 使用する言葉が一定でないため検索に時間が掛かる（文字のゆらぎ）
7. 誰もドキュメントを整理しようとしない、整理の必要性を感じていない
8. タグが使え無い
10. Archiveしない
その結果、
・更新内容が分かりづらいための、現状把握への時間がかかる（アップデート内容が分からない）
・何を目的とした記事なのか分からない（情報共有なのかポエムなのか等）
・完成している文章なのかわからない（信頼のおける文章なのか分からない）
・正直、何の話をしているのかわからない（ディレクトリ構成、ヘッダー、文字のゆらぎが激しすぎる等で理解不能）
・書き捨てられる文章に見える。しかしその実はとても重要な文章である。ただし更新日依存のため見つかりにくい
・ドキュメント作成者は書いて伝えた気持ちになっているが、全く伝わらない
・ドキュメント警察が必要となるが、ドキュメント警察に割ける時間は0。（ドキュメント警察っていうのは、「この書き方がだめ」とかダメだしする役割。修正する役割のことをさした）
まず義務教育で作文ならったのかな。
Markdownやディレクトリ構成、更新方法については教えればいいとして、文章構成が出来ていない点が義務教育を修めたのか懐疑的にさせる。
esaみたいなサービスって他にも結構あると思う。ただいずれにせよ自分達がドキュメントを育てることが出来るのかまずは考えてから使い始めた方が良い。
あとサービスによっては無料期間があるので、その間に見極めることも重要と学んだ。
正直、GoogleDocsを見ても全て「本文スタイル」で書かれていたりとかして、何を使わせても同じなので明らかな能力不足。
Markdownを教えたりとかタグについて決めたりということはしたんだけど、守られないし風化させられる。教える方がバカに思える。
小学生向けの作文の書き方を元に教えたりしたけどだめだった。
ワイの力ではムリでしたごめん
例えば高等裁判所を高裁と略さずに、いちいち高等裁判所と言っていたら、逆に「略せカス」と言われることだろう。
だが略称として頭だけとって高等と言うようにしたら、混乱の極みだろう。
というわけで、増田一のハイセンスな俺が混乱のない略称を考えてやったぞ。
GitHub → Gib（ギブ）
JavaScript → Jast（ジャスト）
デファクトスタンダード → 俗標準
