Island Life - Gaucheにdocstringが無い理由

About 南の島のプログラマ。 たまに役者。 Practical Schemeの主。 WiLiKi:Shiro 最近のエントリ 無限cxr高校受験Defense振り返ってみると2019年は色々学んで楽...覚えるより忘れる方が難しい(こともある)眼鏡のつると3DプリンタIris Klein Acting ClassSAG-AFTRA conservatory: Voice Acting創作活動って自分を晒け出さねばならないと...ループを使わずに1から100までMore... 最近のコメント shiro on 歳を取ると時間が速く過ぎるのは、新しいことに挑戦しないから? (2023/03/14)1357 on 歳を取ると時間が速く過ぎるのは、新しいことに挑戦しないから? (2023/03/01)ベアトリーチェ on ハイポハイポハイポのシューリンガン (2022/04/02)ベアトリーチ

[agw]

コメントにてテストの議論。テストは別に書くほうが好きだなぁ。

[kenichiice]

「そもそも、コードとドキュメントを近くに置くのは良くないと思っている。 」

[ita-wasa]

別の表現を思いついた。Gaucheの設計方針のひとつは、 SICPにある次の文である。 プログラムは、人が読むために書かれるべきであり、それがたまたま機械でも実行できるにすぎない。

[bowbow99]

shiro on docstring; API を使う人向けの documentation と実装の説明は別物、なるほど。

[Ehren]

なるほど。ここらへんは設計思想によるのだろうな。

[yojik]

うむむ。 > "docstringとコードを同居させるには、「コードを読みやすくすること」 か「APIを使う人に役にたつこと」のどちらか、もしくは両方を犠牲にするしかない。"

[syanbi]

コードの近くにドキュメントがあるのがまずい・・・か。考え方それぞれだな