Mark Kettenis <mark.kettenis@xs4all.nl> wrote:

> > Date: Fri, 17 Jan 2025 13:22:37 +0100
> > From: Claudio Jeker <cjeker@diehard.n-r-g.com>
> > 
> > The list of authors does not add value to the bgpd manual page.
> > So I think it is better to just drop them. With this the list of RFCs
> > becomes shorter and is easier to read.
> 
> I know Theo tends to use the word "academic" as an insult,

That goes too far; watch your words.

> but the
> accepted minimal amount of information in a citation most definitely
> does include author names.

Our man pages are not academic.  The intent is succinct, user-focused
documentation explaining the capabilities, use, and limitations of a
component.

RFC citations only need a number and a name.  That satisfies discovery.

Having our manual pages do all this extra is outside our mandate.

I suspect we could remove 90% of non-RFC citations in the man pages
and hurt noone.