Do I understand correctly that this is meant for kind of "one line"
documentation not for something long form?

Not like this:

```
#?

## plus

Arguments:

- x (number)
- y (number)

Returns:

- (number) X and y added together

?#
(define plus
(lambda (x y)
   (+ x y)))
```

But like this:

```
#? Adds x and y together ?#
(define plus
   (lambda (x y)
```

Or should it be, since you mentioned docstrings, like this?:

```
(define plus
   #? Adds x and y together ?#
   (lambda (x y)
```

What happens if (read: when) I try to do this?:

```
(define plus
   #? Adds x and y together ?#
   (lambda (#?number?# x #?number?# y)
     (+ x y)))
```

On 25/05/2024 09:19, Antero Mejr 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!

--
- Retropikzel

https://retropikzel.kapsi.fi