История изменений

Это в б-жественной кложе докстринг часть функции. В недоязычках поддержка докстрингов встречается редко, поэтому документировать функции приходится в комментариях над ними.

Я пока на Common Lisp программировал, тоже думал, что докстринг это хорошо. А потом, когда перешёл на Racket, понял, почему на Common Lisp такая куцая документация. В докстринг совершенно не хочется писать что-то вроде документации к -> и совершенно непонятно где описывать концепции типа https://docs.racket-lang.org/reference/contracts.html.

поэтому документировать функции приходится в комментариях над ними.

Предпочитаешь вместо https://en.cppreference.com/cpp/iterator читать комментарии в https://github.com/gcc-mirror/gcc/blob/master/libstdc%2B%2B-v3/include/bits/iterator_concepts.h ?

Это в б-жественной кложе докстринг часть функции. В недоязычках поддержка докстрингов встречается редко, поэтому документировать функции приходится в комментариях над ними.

Я пока на Common Lisp программировал, тоже думал, что докстринг это хорошо. А потом, когда перешёл на Racket, понял, почему на Common Lisp такая куцая документация. В докстринг совершенно не хочется писать что-то вроде https://docs.racket-lang.org/reference/function-contracts.html#%28form._%28%28lib.racket%2Fcontract%2Fbase..rkt%29.-~3e%2A%29%29 и совершенно непонятно где описывать концепции типа https://docs.racket-lang.org/reference/contracts.html.

поэтому документировать функции приходится в комментариях над ними.

Предпочитаешь вместо https://en.cppreference.com/cpp/iterator читать комментарии в https://github.com/gcc-mirror/gcc/blob/master/libstdc%2B%2B-v3/include/bits/iterator_concepts.h ?