よい製品でもガイドやチュートリアルが難解だと使ってもらえない、ではドキュメントの正しい作成方法とは？
どんなに優れた製品でも、その製品のドキュメントが難解だとユーザーの拡大は難しいもの。そんなドキュメントの「正しい作成方法」について、ウェブアプリのビルドサービスを提供するDivioが解説しています。 The documentation system — Documentation system documentation https://documentation.divio.com/ よい製品でもよいドキュメントがなければユーザーは増えないと多くの人が認識しているにもかかわらず、「正しいドキュメント作成方法」を知らないために、ドキュメント作成に失敗している事例が後を絶たないとDivioは指摘。Divioはドキュメントを「実践的か、理論的か」「学習時に役立つか、作業時に役立つか」の2軸に当てはめ、「チュートリアル」「HowToガイド」「リファレンス」「説明・議論」の4つに分類しています。
ネイティブアプリからGraphQLを叩くときにどこまでパラメータ化するか - hitode909の日記
GraphQLを使って、ネイティブアプリにさまざまな集計方法のランキングを出す、というときについて考えている。 たとえば、ソーシャルブックマークアプリを作っているなら、「総合」「一般」「世の中」「政治と経済」みたいに、カテゴリごとのランキングを出すことがイメージできると思う。 どのようなqueryを用意して、どこまでパラメータ化するか、どこまで自由にするかによって、サーバークライアント間の責任分担や、その後の変更コストが変わってくる。 サーバーサイドで制御する rankings: [Ranking!]!みたいに、クライアントからは「ランキングください」とだけ送るパターンを考えられる。クライアントでは、Arrayの返ってきた順に画面上に表示する。 良い点 サーバーサイドでランキングの定義を持てるので、APIだけでなく、ウェブの画面に表示するランキングなど、他の面との仕様を揃えやすい 変更がサ
「マジで助けてくれ」 試験中止で教授に“リスのさんすうノート”を提出することになった大学生に爆笑
※本記事はアフィリエイトプログラムによる収益を得ています 期末試験中止の代わりにノート提出となったことで、とてつもないピンチを迎えてしまった大学生がいろんな意味で注目を集めています。提出を想定していなかったため、リスの写真がかわいらしい“さんすう”ノートだったのです。主に小学校低学年で使われているやつだー！ 使っていたノート からの無情な宣告 この圧倒的なピンチを迎えてしまったのは、九州大学のたにおさん（＠tsskc）。「誰かマジで助けてくれ」「明日これ持って研究室に行けばいいの？？しんでいい？？」の叫びとともにノートの写真を投稿したところ、18万件近い「いいね」が集まる人気となりました。 表紙には平仮名で名前や「びせき1」と書かれており、本当に小学生が使っているかのような状態。しかし、その中身はちゃんと講義が記録されており、しっかり出席していたことが伺える内容となっています。と同時に、欄
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
