I’ll open another discussion for general rule-bikeshedding later (maybe use the eventual [ANN] thread for that? Feel free to open issues in the repo too), but I’ll mention that the Julia manual that Jakob so kindly linked earlier already prescribes a summary line after the signature:
func(args...; kwargs...)
Summary line written in an imperative style.
A more complete description of the behaviour, arguments,
etc.
You seem to have (to me, weirdly) shuffled the first two elements around, but we can indeed use that initial summary line in the way you link so long as people embrace/conform to it enough.