共有
  • 記事へのコメント17

    • 注目コメント
    • 新着コメント
    その他
    morimarii
    morimarii こういう我流の開陳でドヤるっていろいろきっついわ。。。/読みやすさって曖昧な概念じゃなくてサイエンスなんだっていうところからですね。。。

    2023/02/05 リンク

    その他
    h_taiji
    h_taiji 共有

    2023/02/05 リンク

    その他
    vndn
    vndn 「良い例」が受け入れがたい。極めてわかりにくいと感じるのは私だけなのか。『「認知特性」の有効性について説明する。』と書いてあるけど、「認知特性」の有効性を説明してるように見えないからかなあ。

    2023/02/05 リンク

    その他
    avaravax
    avaravax 概ね同意なんだけど、ちょいちょい主語が省略されてるのが気になる。前の文と同じ主語なら省略していいってこと?

    2023/02/05 リンク

    その他
    estragon
    estragon 2は難しいこともあるよね。とりあえずざっと書いてから推敲したり知見が溜まってきたらリライトしつつ構造変えたりもあって、自分のおすすめは「まず書く」だな

    2023/02/05 リンク

    その他
    rezelolike
    rezelolike 読みやすいドキュメントを書くために今日からできる7つのこと|壮|note

    2023/02/05 リンク

    その他
    xlc
    xlc そもそもここで言う「ドキュメント」とは何を指すのか。Qiitaとかなら「間違えやすいことを正しく伝える」意識で書いて欲しいね。「誰でも知ってることをフォーマットに従って書き直してドヤる」が多すぎる。

    2023/02/05 リンク

    その他
    iekusup
    iekusup ほー。

    2023/02/05 リンク

    その他
    kowa
    kowa 悪い例として挙げられているのがそれほど悪くなく、修正も容易に見える。悪文はそもそも意味が分からないうえ手が付けられないレベル。「ロジカルであれ」ってよく言われるけどどういうことなんだろ?

    2023/02/05 リンク

    その他
    Windymelt
    Windymelt "一文一義"

    2023/02/05 リンク

    その他
    ya--mada
    ya--mada メガベンチャーを自称する会社って具体的にはどこなんだろ?

    2023/02/05 リンク

    その他
    catalog360
    catalog360 “悪い例”はやることとその理由が最初に端的に述べられ分かりやすいが、後の用語の説明は上手くない。だが“よい例”は向かう先が知らされぬまま用語の説明が続き、やっと最後に具体策を言うのでもっと悪い。

    2023/02/05 リンク

    その他
    tettekete37564
    tettekete37564 1番重要な事を最後の備考や注釈に書くアホは死んで欲しい。

    2023/02/05 リンク

    その他
    Wafer
    Wafer https://note.kishidanami.com/n/n6cc7d7d8a1de "難関中学の入試問題の原作者になったけど設問が解けない理由を考えて、編集者にたどり着いた" とあわせて読むとより面白い

    2023/02/05 リンク

    その他
    showii
    showii 読みやすい。が別に中身が目新しいわけでもないような。

    2023/02/04 リンク

    その他
    sumanhoho
    sumanhoho 読みやすさを意識しすぎて読点が多い気がする

    2023/02/04 リンク

    その他

    注目コメント算出アルゴリズムの一部にLINEヤフー株式会社の「建設的コメント順位付けモデルAPI」を使用しています

    アプリのスクリーンショット
    いまの話題をアプリでチェック!
    • バナー広告なし
    • ミュート機能あり
    • ダークモード搭載
    アプリをダウンロード

    関連記事

    読みやすいドキュメントを書くために今日からできる7つのこと|壮|Masato Tanaka

    こんにちは。壮(@sew_sou19)と申します。 メガベンチャー企業でエンジニアとして働いています。 エン...

    ブックマークしたユーザー

    すべてのユーザーの
    詳細を表示します

    同じサイトの新着

    同じサイトの新着をもっと読む

    いま人気の記事

    いま人気の記事をもっと読む

    いま人気の記事 - テクノロジー

    いま人気の記事 - テクノロジーをもっと読む

    新着記事 - テクノロジー

    新着記事 - テクノロジーをもっと読む

    同時期にブックマークされた記事