I personally don't see a reason to document something other then top level
entities that you can access from REPL, like procedures, macros, and
variables.

In LIPS I've implemented same mechanism as in Emacs Lisp and Python. I don't
see a reason for specific syntax for docstrings, as name suggests they should
be strings.

In LIPS I have this syntax:

(define (foo x)
  "This is doc string"
  (+ x x))

(define-macro (foo x)
  "This is doc string)
  `(list ,x))

Additionally when defining variables or hygienic macros doc string is at the
end.

(define foo 10 "this is doc string")

(define-syntax foo (syntax-rules () ((_ x) x)) "this is doc string")

On Sat, 25 May 2024 06:19:08 +0000
Antero Mejr <xxxxxx@antr.me> wrote:

> I would like to propose a SRFI for in-source documentation (AKA
> docstrings). The syntax is similar to #| multi-line comments. The
> repository is here:
> https://github.com/pre-srfi/in-source-documentation
>
> Thanks!

--
Jakub T. Jankiewicz, Senior Front-End Developer
https://jcubic.pl/me
https://lips.js.org
https://koduj.org