ドキュメントを書くときの「メンタルモデルの原則」 - クックパッド開発者ブログ
こんにちは。クリエイション開発部の丸山@h13i32maruです。 みなさんドキュメント書いてますか？私はドキュメントを書くのは結構好きです。最近もプライベートで開発しているJasperというGitHub用Issueリーダーのユーザ向けドキュメント（マニュアル）を書きました。でも良いドキュメントを書くのって難しいですよね。 そこで、本記事では「ツールやライブラリなどを対象にしたユーザ向けドキュメント」を書くときに私が考える原則を紹介します。ちなみに私はテクニカルライティングの専門家ではなく、普通のソフトウェアエンジニアです。そのあたりはいい感じに汲み取っていただけると🙏 🕵️メンタルモデルの原則 良いドキュメントとはどのようなものなのでしょうか？私は「そのツールやライブラリに対して読者がメンタルモデルを構築できる」のが良いドキュメントだと考えています。これを「メンタルモデルの原則」と呼
「自分より優秀な人」よりも「自分よりも専門的な人」を採用しよう - 宮田昇始のブログ
「自分より優秀な人を採用しなさい」 スタートアップをやっていると、先輩起業家や投資家から「自分より優秀な人を採用しなさい」とよく言われます。 たぶん、初期スタートアップへの定番アドバイス第2位です。（第1位は創業者間契約書） でも、これを言葉通りに受け取るとめちゃムズカシイですよね？？ 「全ての能力が自分よりも上」な人は来ない この「自分より優秀」を「全ての能力が自分よりも上」と捉えてしまうと、いつまでも採用できません。 『この人、営業としては超優秀そうだけど、テクノロジーは自分のほうが強そう...』 『この人、エンジニアとしては超優秀そうだけど、リーダーシップは自分のほうが強そう...』 的な。 もちろん、時間がゆるすのであれば、そんな人が来る日を待ってもいいのかもしれません。 しかし、スタートアップの初期はとにかく時間がありません。待っている間に人手不足は深刻になり、競合に追い抜かれ、
面接用スライドを公開した結果、全部見せます！ - 宮田昇始のブログ
昨年の8月に、採用面接用の会社紹介資料をSpeaker Deckで公開しました。 公開から半年たったので、今回はその『結果』について具体的な数字を交えてブログにしてみました。 ちなみに次回のブログでは、公開に至った経緯や、大変だったことについて書きたいと思います。気が早いですが次回もお楽しみに。 実際のスライドがこちら。見たことある人は読み飛ばしてください。見たことない人はぜひ見てね。 公開後、何度かアップデートしてますが、コンテンツはほぼそのままです。 応募数は『5.3倍』に増加 早速ですが、一番気になる「応募者数」の推移です。 エージェントさん経由の応募は含まない、直接応募のみのグラフです。 応募者数は『5.3倍』に増加!! 公開前と比較して、なんと5.3倍に増えました。すごーい。 こんなに応募が増えたのは完全に予想外で、うれしい誤算でした。 会社紹介が『24万回』も見られている 単純
ブログ名ってどうやって決めたの？ 人気ブロガー、らくからちゃ＆かあいがもんの場合 - 週刊はてなブログ
ブログを自己表現やブランディング、さらに個人のメディアとして利用するときに、大切なことはブログのコンセプトを明らかにすることです。どういった記事を書くのかにとどまらず、どんなブログ名（およびドメイン名）を付けて運営するのかということも、実はブログのコンセプトに深く関係してきます。 はてなブックマークの人気エントリーにも記事がいくつも入っているブログ「ゆとりずむ」のらくからちゃ（id:lacucaracha）さんと、「お父さんの日記」のかあいがもん（id:otousan-diary）さん。お二人はブログのコンセプトをどのように考え、ブログ名やドメイン名にはその思いがどのように生きているのでしょうか？ ※この記事は、GMOインターネット株式会社提供によるPR記事です。 ▼ブログを見返して、これから何を書いていくかを自問自答することで、改めてコンセプトが固まりました／らくからちゃさん ＿＿ブログ
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
zinseitanosiku.com
