パスワードを忘れた? アカウント作成
この議論は賞味期限が切れたので、アーカイブ化されています。 新たにコメントを付けることはできません。

FOSSのドキュメントが残念な状態で知りたいことがわからなかったら、どうやって解決する?」記事へのコメント

  • ソースから (スコア:2, 興味深い)

    by Anonymous Coward

    開発者が書かないでいる以上は、だれかがソースから解読してドキュメントを起こすしかないんだろうなあ。
    読めても書けない人はそういう貢献もあるねってことで。

    • by Anonymous Coward on 2014年08月09日 23時27分 (#2654118)

      ソース見れば実装はわかるけど、その背景や考え方がわからなかったりすることも多いんだよね。
      「この機能は旧バージョンとの互換のためのもので今後廃止される予定である。そのため、今後は新しい機能を使うべきである」、とか。

      親コメント
      • by Anonymous Coward on 2014年08月10日 10時33分 (#2654213)

        人のコードを触る業務が多いのですが、「背景の考え方」ってのが一番重要だと思ったり。
        実装されているコードってのは、やろうとしている(いた)ことの一側面を記述しているに過ぎないと思いますです。

        親コメント
        • Re:ソースから (スコア:2, すばらしい洞察)

          by Anonymous Coward on 2014年08月10日 19時09分 (#2654363)

          すごく賛同します
          既存のソースコードからドキュメントを起こすという作業をしたことがあります

          そのまま「こういう入力があればこういう動きをする」という部分は難なく書けるのですが
          「なぜその動きをするのか」は推測するしかないんですね

          # で,とりあえず推測でテキトーな理由をでっち上げてお茶を濁すしかないんです...

          親コメント
          • by Anonymous Coward

            あるある。特に困るのが
            何を目的としてこんな実装してんだよ、っての。
            しかもバグなのかどうなのか正解がさっぱりわからん系な。

            その手のは詳細設計にも取りこぼされる事が多いから
            第三者に向けたソースコメントを書け、と指導してる

            • by Anonymous Coward on 2014年08月11日 8時05分 (#2654563)

              そのコメントが「こう動く」ってだけの内容ではなく、「○○と考えたので、□□のパターンで実装した」とかだと非常に助かる。

              親コメント

UNIXはただ死んだだけでなく、本当にひどい臭いを放ち始めている -- あるソフトウェアエンジニア

処理中...