アカウント名:
パスワード:
The Art of Computer Programming のような、「プログラミングについての書籍」を作る場合だからこそ「コードそのものをドキュメントに埋め込んで解説する」というWEBが意味を持つのだと思います。
普通の用途だと、インプットとアウトプットさえ明確なら、その内部実装は見えなくてもいいというか見えない方がいい、ということで「プログラムのドキュメント」の作成方法としては、入出力仕様だけをドキュメント化するdoxygenのようなドキュメントツールの方が使い勝手がいいでしょう。(挙げられた例だと、普通のプログラムドキュメントとしては「g(n) \equiv 3f(\sum_{k=1}^{7}k^n)」を求める関数である、と説明するのが最重要で、その内部実装をいちいち逐次説明なんてするな、って感じ。)
The Art of Computer Programming がWEBで書かれていたかどうかは忘れてしまいましたが，それはさておき「プログラミングにおけるインタフェースと実装の分離」という目標と「文芸的プログラミング」という目標はご指摘の通り両立しないですね．
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
普通のやつらの下を行け -- バッドノウハウ専門家
doxygen (スコア:1)
The Art of Computer Programming のような、「プログラミングについての書籍」を作る場合だからこそ「コードそのものをドキュメントに埋め込んで解説する」というWEBが意味を持つのだと思います。
普通の用途だと、インプットとアウトプットさえ明確なら、その内部実装は見えなくてもいいというか見えない方がいい、ということで
「プログラムのドキュメント」の作成方法としては、入出力仕様だけをドキュメント化するdoxygenのようなドキュメントツールの方が使い勝手がいいでしょう。
(挙げられた例だと、普通のプログラムドキュメントとしては「g(n) \equiv 3f(\sum_{k=1}^{7}k^n)」を求める関数である、と説明するのが最重要で、その内部実装をいちいち逐次説明なんてするな、って感じ。)
Re:doxygen (スコア:2)
The Art of Computer Programming がWEBで書かれていたかどうかは忘れてしまいましたが，それはさておき「プログラミングにおけるインタフェースと実装の分離」という目標と「文芸的プログラミング」という目標はご指摘の通り両立しないですね．