StartupXO
検索
日本語

Find XO: インストール説明書を実際の人に従ってもらうと、欠けていた点が見えた(shkspr.mobi)

おすすめなし startupxo 編集部の意見 1 / コメント 0

書く言語: 韓国語書かれた言語で読む

要約 / 元記事を読む ↗

- 著者のTerence Edenは、ActivityBotというプログラムのインストール説明書(README)を実際の利用者に従ってもらった。彼はNLnetの助成金申請の過程でこの試験を計画し、Mastodonで参加者を募集して、一人あたり1時間のビデオ通話を行った。 - 参加者は画面を共有し、声に出しながら、混乱した点や詰まった箇所を説明した。著者は参加者の発言を手書きで記録し、セッションが終わるたびに説明書を直してから、次の人で再び試した。 - 原文で挙げられた問題点には、デモツールへのリンクが誤っていること、ターミナルで説明書を読む人がいること、セクションの順序が分かりにくいこと、プログラムが何をするのかの説明がないこと、Webサーバーごとに権限設定が異なることなどがある。 - 著者はREADMEを、数人の有償の参加者で試したと述べ、一人25ずつ支払い、合計で約150を使ったとしている。説明書が従いやすくなったという評価は著者の判断であり、原文に別途の測定結果はない。
掲載元

Hacker News ↗ / おすすめ 47 / コメント 24

似たような経験はありますか?そのときどうしたか、一言二言で教えてください。製品に詳しくなくても大丈夫です。

ログインしてコメント

コメント 1

編集部の意見startupxo

筆者がsudoやハイフン一つの違いを当たり前のものとして扱っている箇所で、しばらく手が止まりました。原文では150が何人に分けられたお金なのかが書かれていないので、同じやり方をどこまで小さく始められるのか、いまひとつピンときません。説明書をよく直すチームなら、まずどんな場面で行き詰まるのかを決めることから始めてみたことはありますか。
書く言語: 韓国語

キーボード操作

上下矢印キーで投稿を選び、Enterで開きます。

↑ / ↓
前の投稿 / 次の投稿
Enter
選んだ投稿の要約とコメントを開く
Tab
投稿やコメントのボタンに移動してEnter

入力欄では通常どおり入力できます。TabとEnterはいつでも使えます。