テクニカルドキュメントの構造化フレームワーク Diátaxis とは - A Memorandum
Diátaxisとは Tutorials How-to guides Reference Explanation Diátaxisとは Diátaxisとはテクニカルドキュメントの構造化フレームワークです。 ユーザーのニーズの体系的な説明と分析に基づいて文書構造を規定するスキームを提供し、多くのソフトウェアのテクニカルドキュメントの体系として採用されています。 Diátaxis という名前は、古代ギリシャ語の dia (横切る)と、taxis(整理・配置) に由来するそうです。 diataxis.fr ドキュメンテーションを 2 つの知識軸 (理論/実践、および習得/応用) に分割して整理 TutorialsとHow-to guidesの両方で、実践的な手順を説明 How-to guidesとReferenceは知識の応用に関係 Reference と Explanation に理論的知識
Remote Team Interactions Workbookまとめ
Remote Team Interactions Workbook: Using Team Topologies Patterns for Remote Working Remote Team Interactions Workbookは、 チームトポロジー 価値あるソフトウェアをすばやく届ける適応型組織設計を書いたMatthew SkeltonとManuel Paisによるチームトポロジーをリモートワークに適応させることに焦点を当てた本です。 チームトポロジーについては、以下の訳者の方の資料がわかりやすいです。 2020年以降のCOVID-19の大流行は、多くの企業の働き方を変化させ、新たなリモートファーストの世界を到来させました。特にIT業界においては多くの企業がリモートワークに切り替えを行い、この変化は非可逆のものだと感じています。 しかし多くの企業はその変化に適応するのに苦労してい
いまこそ「良い仕様書」がチームの生産性の鍵となる。ので、仕様書に含めたい 14 のポイントについてまとめました。｜Fritz | Lead Product Manager @ Mercari
いまこそ「良い仕様書」がチームの生産性の鍵となる。ので、仕様書に含めたい 14 のポイントについてまとめました。 こんにちは、フリッツ です。今回はプロダクトマネージャーの日課とも言える「仕様書」について。自分にとっては PM 業の施策実行フェーズにおいて最も重要な仕事のひとつであり、最も心躍り、最も興奮する瞬間です。 PM になってかなりの時間が経ちましたが、「仕様書」への力の入れようは減るどころか、「もっと気合を入れなければ。」と感じる一方。在宅勤務が（たぶん） IT 業界のニュースタンダードとなっていくいま、なおさら「仕様書」の重要性を訴えたい今日この頃です。 ということで、今回は ・ 良い仕様書がもたらす 5 つの効果 ・ 仕様書の重要性が増していく 2 つの理由 ・ 仕様書に含めたい 14 の項目・実戦編 ・ 仕様書作成時に心に留めたい 3 つのこと ・ 具体的な仕様書サンプル（
リモートワークのオンライン会議やペア作業で心がけている8つのTips | DevelopersIO
クラスメソッドのリモートワーク（テレワーク・在宅勤務）は、リモートワークをすることが目的ではなく、より良い成果を出す手段の1つです。 そんなリモートワークですが、私自身は「オンライン会議（朝会）」や「ペア作業（ペアプロ）」等をすることが多いです。 下記の記事を見て、「みんな色々と考えているんだなぁ」と思い、私も含めた参加メンバーが少しでも効率よく・気持ちよく作業するために心がけていることを書いてみることにしました。 やっぱり難易度の高い在宅勤務をちょっとでもうまくやるために心がけていること ｜ Developers.IO 心がけていること リアル対話と比べて、オンライン対話は情報量が減ります。表情・身体の動き・声色などです。 これらをオンライン対話でも意識的にやっていこう！という考え方です。 顔芸をする オーバーリアクション 相づちを打つ 手を挙げる 問いかけの場合は、最初に相手の名前を言
外資系企業で学んだ「何が起こりますか？対象者は誰ですか？何をしなければなりませんか？」スタイルのアナウンスメール - give IT a try
はじめに 僕の前職は外資系企業でした。 その当時、アメリカ本社からときどき送られてきた社内アナウンスメールのフォーマットがなかなか良かったので、今でもときどき使っています。 特に、このフォーマットは何かをお知らせするだけでなく、社員に何かしらのアクションをお願いするときに有用です。 というわけで、このエントリではこのメールフォーマット（記述スタイル）を紹介します。 「何が起こりますか？対象者は誰ですか？何をしなければなりませんか？」スタイルのアナウンスメールの記述例 どんなフォーマットなのかというと、「何が起こりますか？対象者は誰ですか？何をしなければなりませんか？」を見出しに書いて、本文を埋めていくフォーマットです。 たとえばこんな感じです。 社員各位 ○○○○○の計画メンテナンスについてお知らせします。 以下の内容を確認してください。 何が起こりますか？ 2020年1月11日（土）15
社内情報共有についての考え方 - An Epicurean
タイトルのようなエントリを社内に向けて書いたので、手直しして社外に放流するものである。 社内で情報共有フローやガイドライン整備などを進めている。ルールは少ないに越したことはないので「ルール作り」にはしたくなくて、考え方やガイドラインみたいなところに留めて、文化や共通言語を醸成していきたいとも考えている。 これは、今後組織が大きくなる上で、「スピードを落とさないため」に必要だと考えている。新しく入ってきた人が立ち上がりを早くパフォーマンスを発揮してもらえるようにしたい。 オンボーディングの整備は大事で、それもやっていかないといけない。でも今のフェーズではどうしても未整備の部分も多い。そういう荒地を楽しんで走破できる自走力があって、自分で決めて整備もできて、組織と一緒に成長してくれる人を採用していきたい。なので「自走しやすい環境」を整えたい。そのために必要だと考えている点が以下の3点です。 デ
インシデント指揮官トレーニングの手引き | Yakst
[SRE]原文 An Incident Command Training Handbook – Dan Slimmon (English) 原文著者 Dan Slimmon 原文公開日 2019-06-24 翻訳依頼者 翻訳者 meiq 翻訳レビュアー doublemarket 原著者への翻訳報告 1496日前 Twitterで報告済み 編集 私が Hashicorp で担った最初の仕事のひとつは、社内向けのインシデント指揮官のトレーニング資料を作ることでした。 これは私自身がインシデントへの対処にあたりながら何年ものあいだ肌身に感じてきた、あらゆる類の考えをまとめ上げる良い機会となり、最高に面白いタスクでした。 以下は私の書いたトレーニング資料、ほぼそのままです。 あなたがインシデントレスポンスのポリシーを定義するにせよ、即興でインシデントレスポンスを行うにせよ、お役に立てたら幸いです。
「エビデンスで殴る」というやり方は、なぜうまくいかないのか（斎藤 清二） @gendai_biz
「エビデンス」は万能か？ SNSをはじめとするインターネット上では、さまざまな社会問題について活発な議論が行われている。特に健康や医療をめぐる話題については、さまざまな人々がさまざまな見解をもつことは当然で、それぞれの意見を交流させることは、社会全体の知識の量と質を高めていくことにも役立つだろう。 しかし、極端に見解が異なる人の間で意見が衝突したり、時にはあまりにも感情的な議論が続いたり、人格を否定したり傷つけあったりするような交流が起こるとすれば、それ自体は好ましいこととは言えない。そのような交流自体が関係者の健康を損ねてしまうこともある。 このような議論の場に足を踏み入れようとすると、まるで地雷原を歩いているような気持になる。少し遡ればホメオパチー（ホメオパシーと表記することもある）などの代替医療をめぐる議論、原発事故の放射能による健康被害をめぐる議論、最近の例で言えばHPVワクチンの
会社の電話をなくしたら、大口顧客に切られ、売上1割ダウン。それでも「正しかった」と胸を張る理由 | ハイクラス転職ならdoda X（デューダエックス）
doda X（旧：iX転職）は、パーソルキャリアが運営するハイクラス転職サービス。今すぐ転職しない方にも登録いただいています。 今の自分の市場価値を確かめてみましょう。 LINEやチャットワーク、メッセンジャーなどチャットツールが仕事の連絡を取り合う主な手段という企業がIT業界などで徐々に増えつつあります。しかし、そうではない業界、企業ではいまだに「電話」が主流、固定電話にしても、会社から支給される携帯電話にしても、それがなくなっては困るという企業がほとんどでしょう。 そんななか、オフィス移転を機に「会社の電話をなくした」企業があります。サイト内検索技術などを開発・提供する日本発のグローバルBtoB企業、マーズフラッグ社です。同社は北米・シンガポール・上海など海外でも事業を展開し、サイト内検索市場では国内トップシェアを誇る、数少ない ”IT業界でGoogleに勝った” 日本の企業です。 営
“人の魅力”見えるECを目指したい--日本酒定期購入サービス「SAKELIFE」
有限会社油忠は4月20日、日本酒の定期購入サービス「SAKELIFE」をオープンした。 SAKELIFEでは、月額3000円と5000円の2つのコースを設定し、毎月同社が選んだ日本酒1本（基本的には5000円で一升瓶1本か四合瓶2本。3000円では四合瓶1本。日本酒の価格によりサイズは変動する）を定期的に送付する。 加えて、隔月でお猪口や徳利、燗つけ器といった酒器を送付するほか、毎週1回メールマガジンを発行し、体に負担をかけない飲み方や、日本酒に関わる各種の情報を配信する。またTwitterアカウントなどを通じたコミュニケーションも行っていく。 日本酒の送付先住所は毎月変更可能なほか、ギフト用のラッピングにも対応する。「毎月一升瓶1本も消費できない」というユーザーが、ある月は友人へのプレゼントに日本酒を送る、といった使い方も可能だ。支払いは現在PayPalのみだが、今後は他の方法も検討いて
「叱られ下手な人に会うと、たいていの人は叱り下手になってしまう」 という視点 - シロクマの屑籠
先日まとめた『叱られると自動的にごめんなさいしか言えなくなる人達』に、補足したくなるようなツイートを発見しました。 うーん。俺が他人を怒ることは稀なのだが、「ごめんなさい」主義の人と相互作用を起こし？一時間以上説教モードになったことがある。「指摘の件は承りました。再検討致します」と言って欲しかっただけなのに。 / 叱られると自動的にごめんなさいしか言 URL 2011-05-06 00:17:39 via Hatena 上記ツイートのなかで @REVI さんは、「自分は普段は滅多に怒らない筈なのに、“ごめんなさい主義の人”との間では説教モードになった」と書いています。こういった「普段は滅多なことでは怒ったり叱ったりすることが無いのに、“ごめんなさい”を連呼するだけの相手の時にはそうではなくなった」という経験をしたことのある人は、たぶん結構いるんじゃないでしょうか。 理由としてわかりやすい考
理不尽にやると上手くいく - レジデント初期研修用資料
ちょっと前、「ジューサーの中に金魚を入れる」という現代美術の展示があった。 ジューサーの中に金魚と水が入っていて、スイッチだけリモコンで、観客の側に置かれる。観客は誰もがそのスイッチを押すことができるようになっていて、「いつでも金魚を殺せる」という、その感覚が展示になっていた。 金魚の寿命を延ばすもの この展示で、実際にボタンを押せた人はたぶんいないのだろうけれど、これをたとえば、ジューサーに入れた金魚をインターネットで公開して、ネットの向こう側にいる誰もが、匿名のままそのボタンをクリックできるようにしておくと、誰かがボタンを押してしまう。多数決ルールを導入して、「ボタンを押した人が累計で10人を超えたら、ジューサーの電源が入ります」という看板を出しておくと、ボタンが押される閾値はますます下がる。 匿名ルールを廃して、たとえばTwitter のような、押した人をある程度トレースできるメディ
Facebookと〈私〉 – 橘玲 公式BLOG
映画『ソーシャル・ネットワーク』のヒットもあって、Facebookに注目が集まっている。 すでにさんざんいわれているけれど、Facebookは実名主義で、学歴や職歴、趣味だけでなく、宗教や政治的立場の入力欄があり、多くのひとが顔写真を載せている。それに対して日本は、2chに代表されるように匿名主義が主流で、SNS最大手のmixiは、ユーザーの登録情報を実名にしたところトラブルが続出したため、匿名で登録しニックネームでやり取りするのが一般的になった。 実名主義と匿名主義は、ナッシュ均衡の関係にある。大半のひとが実名でSNSを利用しているのであれば、自分だけ匿名なのは、やましいことがあると告白しているのと同じだ。逆にみんなが匿名で情報交換する場所で、一人だけ顔と名前をさらすのは、トラブルを招き寄せるようなものだろう。 実名主義の社会では、自分がひとよりどれだけ目立つかを競うのがデフォルトのゲー
コピペはダメだよ、について - 内田樹の研究室
卒論を読んでコメントをつけて返すという仕事をしている。 疲れる。 ほとんど同じことをどの学生についても書いているからである。 「出典の書誌情報を明記しなさい」 この二年間、ことあるごとにゼミで言っているのだが、ほとんどの学生はそのほんとうの意味は理解していない。 それをたぶん「ズルをしてはいけません」という警告のように聴いているのだろうと思う。 「カンニングするな」とか「授業中私語をするな」とか「教室でカップ麺を食べるな」というような注意と同列のものだと、たぶん思っている。 しているところを見つかったら叱られるけれど、見つからなければどうってことない、とたぶん思っている。 それでいったい誰が困るというのよ、とたぶん思っている（キムチ味のラーメン臭が教室に漂っていると、次の授業に教室を使うものは苦しむぞ）。 自己利益の追求を優先させることは悪いことではない、と教えられてきたからである。 自己
レジデント初期研修用資料 医療とコミュニケーションについて | Ohmsha
はじめに 第1章 話を聞く 第2章 問題を受け止める 第3章 話を続ける 第4章 分かりやすく説明する 第5章 チームを説得する 第6章 医療ミスの起こるメカニズム 第7章 ミスを素早く発見する 第8章 抑止力を運用する 第9章 謝罪を行う 第10章 交渉の外にいる人 付録 訴訟になったら はじめに 医療におけるコミュニケーションとは何か この本における「コミュニケーション」 本書の概略 第1章 話を聞く 1.1 面白い話はしなくていい 1.2 病院の地の利を生かす 1.3 遭遇における先手の問題 1.4 同意獲得と合意形成 第2章 問題を受け止める 2.1 否定を使わない外来対応 2.2 分からない患者さんへの対応 2.3 次につながる会話の切りかた 第3章 話を続ける 3.1 会話の続けかた 3.2 話すときに気をつけるべきこと 第4章 分かりやすく説明する 4.1 患者さんに理解して
道徳とルールの間 - レジデント初期研修用資料
少し前、警察の任意取り調べにおける録音は、是か非か？ という議論が話題になっていた。 法律家の卵（？）の人が、取り調べの現場に録音機を導入することの弊害を説いて、「そんなことはない」という突っ込みを受けて、 ちょっと盛り上がっていた。 道徳とルールには溝がある 世の中にはたぶん、「道徳」が好きな人と「ルール」が好きな人とがいて、両方とも、同じところを目指しているわりに、お互いの溝はけっこう深い。 くだんの議論で録音機の弊害を説いていた方は、恐らくは正義感が強い人であって、録音機という、「人間は必ず嘘をつく」ということが半ば前提になっている機械を 仕事場に持ち込むことに対して、嫌悪感みたいなものを持っているのだと思う。 一方で、録音機というものは、米国司法の現場であったり、「言った言わない」が問題になる仕事の現場では、もはや当たり前のように用いられている 道具でもあって、どんな業界であっても
搾取されないためには選択肢を増やすしかない – 愛の日記
ブラック企業は今後とも蔓延するだろう。政府は今後ともサービスの質を改善することなく増税し続けるんじゃなかろうか。 そう思う理由は、こんな感じ： ブラック企業も、日本政府も、慈善事業ではないのでプロとして合理的な取引をしているだけ。取引では、交渉力のある相手が、交渉力のない相手から、限界まで搾取するのが基本。 多くの日本人には選択肢がないので、交渉力がない。（収入を正当化するスキルがないこと、意思決定時にリスクとリターンのバランスを取れないこと、日本語以外で実務上のコミュニケーションが取れないことなど、色々な理由によって。） 僕が思うに、ブラック企業が成立するのは、企業が悪である時ではない。企業は社員の交渉力に応じて自然な反応をしているだけだ。社員がブラックなほどに選択肢がない時にのみ、ブラック企業は成立する。搾取しても、どうせ社員はいいなりで、やめないからである。 税金あたりの国家サービス
論理的言明を装った感情論は嫌い、という感情論 - 檜山正幸のキマイラ飼育記 (はてなBlog)
ちょっと時間がたってしまったネタですが： プログラミングの出来る人と出来ない人の決定的な違い。 「プログラミングの出来る人と出来ない人の決定的な違い」？ ワンヤグさんの「プログラミングの出来る人と出来ない人の決定的な違い。」は、たくさんのブックマークを集めた記事。それに対して、id:JavaBlackさんが随分と否定的な記事を書き、さらにワンヤグさんが当該記事への追記として反論（らしきこと）を書いています。内容的に、ドチラかが全面的に正しいとは思えないし、ドチラかに味方する気もありません。 ですが、僕のセンサー（どんなセンサーかは最後に述べます）が反応したので、思うところを書いておきます。 時間順が前後しますが、まずはJavaBlackさんの記事のほうから。僕は、元記事「プログラミングの出来る人と出来ない人の決定的な違い。」を読む前に、JavaBlackさんの記事のほうを先に読んだのです。
常識がプライベート化していく――Common Sense からPrivate Senseへ - シロクマの屑籠
常識（じょうしき）は、社会の構成員が有していて当たり前のものとしている価値観、知識、判断力のこと。その社会に適した常識を欠いている場合、社会生活上に支障をきたすことも多い。これは文化摩擦などとして表面化することもある。社会によって常識は異なるため、ある社会の常識が他の社会の非常識となることも珍しくない。 (wikipediaより抜粋) 英語の Common Sense が訳されて、常識という日本語が誕生したという。 このことが示すように、常識というのは世間一般で共通している認識、という意味だったと思う。少なくとも、過去の時代においては。 しかし、現代の日本社会では、そうでもなくなってきている。Common Sense ならぬ Private Sense と言いたくなるような、常識のプライベート化が(程度問題はあるにせよ)進行しているようにみえる。 常識のインストール元が「社会」「地域」から
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
リモートワークにおけるファシリテーションの方法論
