記事へのコメント21

    • 人気コメント
    • 新着コメント
    spfrv72010 spfrv72010 ウォーターフォール式の開発時と、単体製造後に必要となる設計文書って異なると思う。前者は大概処理手順とか記述するけど、後者で目的と諸元だけ知りたい時のノイズだし、変更時は文書とコードで二重の手間になる。

    2021/10/30 リンク

    その他
    yogasa yogasa インセンティブが弱いんだろうなあ

    2021/10/30 リンク

    その他
    morimarii morimarii 普段使わなくてもシステム移行時に参照が必要だったりするからなあ。そういうのがないと意図不明なロジックや設定が呪文や石碑のように受け継がれていく。。。

    2021/10/30 リンク

    その他
    to4iki to4iki “詳細に書きすぎない” わかりみ

    2021/10/30 リンク

    その他
    lets_skeptic lets_skeptic ソースコードのコメントには概略とwikiへのリンクを書く

    2021/10/30 リンク

    その他
    nlogn nlogn この問題を解決するのがクヌース先生のWEBシステムなのだが、プログラマの多くは文章が書けないため広がらなかった。

    2021/10/30 リンク

    その他
    alphaorange69 alphaorange69 キーワードが時間とともに迷子になるというか、、難しい

    2021/10/29 リンク

    その他
    kaakaa_hoe kaakaa_hoe 使うのは勿論そうなんだけど、初めて読む時の感覚は1人一回しか味わえないので、そんなに人間いないよねとなりそうな。主管付けながらEdit on GitHubとかで提案しやすくするのが関の山。

    2021/10/29 リンク

    その他
    blackblueash blackblueash 結構更新してるよ。

    2021/10/29 リンク

    その他
    hkawaras hkawaras 詳細に書きすぎない分かる。変更箇所生まれたら変更するのしんどいときがある

    2021/10/29 リンク

    その他
    udofukui udofukui 知見ありがとう。そしてもっと色んな人出してほしい。

    2021/10/29 リンク

    その他
    strawberryhunter strawberryhunter プログラムを読んで自然言語で要約してくれるプログラムがあればいいんじゃね?自然言語の要約よりよっぽど簡単な気がするので誰かチャレンジしてください。

    2021/10/29 リンク

    その他
    turanukimaru turanukimaru 最近は「自分が何を作ってるのかわかってないのでドキュメントを書かないし更新しないスクラム」ばかりに参加してる。プロダクトオーナーがプログラムもドキュメントも主体的にまとめていかないといけないんじゃ…

    2021/10/29 リンク

    その他
    miki3k miki3k 知る限り20年以上前からずっと言われ続けている

    2021/10/29 リンク

    その他
    s5r s5r ドキュメントによるのでは。更新されてなくても書いてさえくれれば困った時に後からいくらでも掘り下げられるので、日頃から整理しようとか使おうとかしている時点で間違っている気がする。

    2021/10/29 リンク

    その他
    cl-gaku cl-gaku 使うしかない。使わないドキュメント書く時間の虚無感は異常

    2021/10/29 リンク

    その他
    ema_hiro ema_hiro ドキュメント警察ともいうべき属人的筋肉運用に頼りがちなんだよなぁ。。。

    2021/10/29 リンク

    その他
    sgo2 sgo2 読みたくなるのは、ソースの意図が分からない時なので、ソースやテストコードのコメント/リポジトリのログにこのドキュメントを読めと書いておいて欲しい。

    2021/10/29 リンク

    その他
    shinobue679fbea shinobue679fbea 使う。これに尽き申す

    2021/10/29 リンク

    その他
    luccafort luccafort 自分の理解では…という感じだけどドキュメントメンテ問題は「読まれない」が最大の問題だと思うので読まれるようなフローを整備するのが一番いいんだろうなと思う。そのうえで使われるために書きすぎないようにする

    2021/10/29 リンク

    その他
    hurutoriya hurutoriya めちゃくちゃわかりみが深い。言及されてる通り定期的に参照されるような仕組みを作るのが情報の劣化を防ぐための第一歩で、次がドキュメトを自分も書いてみようかなという気持ちを湧き起こすの大事。

    2021/10/29 リンク

    その他

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

    関連記事

    ドキュメントが更新されない問題 - Konifar's ZATSU

    むかし、この国が深い森におおわれ、そこに太古からの神々がすんでいた頃から語り尽くされているドキュ...

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

    • kyaido2021/11/19 kyaido
    • muneniku56562021/11/19 muneniku5656
    • Kamekiti2021/11/11 Kamekiti
    • sorokatu2021/11/01 sorokatu
    • makopy_inside2021/11/01 makopy_inside
    • sskoji2021/10/31 sskoji
    • tasukuchan2021/10/31 tasukuchan
    • t0m02021/10/30 t0m0
    • daisuke_nomula2021/10/30 daisuke_nomula
    • gonhainu2021/10/30 gonhainu
    • toenobu2021/10/30 toenobu
    • k1LoW2021/10/30 k1LoW
    • yotubaiotona2021/10/30 yotubaiotona
    • spfrv720102021/10/30 spfrv72010
    • pomgr2021/10/30 pomgr
    • koma_g2021/10/30 koma_g
    • yug12242021/10/30 yug1224
    • Hiro_Matsuno2021/10/30 Hiro_Matsuno
    すべてのユーザーの
    詳細を表示します

    同じサイトの新着

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

    いま人気の記事

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

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

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

    新着記事 - テクノロジー

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

    「FF5」ピクセルリマスター版はPCとモバイルに向けて11月10日リリースと海外向けに発表

    2 users https://www.4gamer.net/

    川村ゆきえ 水着・グラビア画像53

    1 user http://nipponjinn22.blog.2nt.com/