Thread (5 messages) flat view 5 messages, 5 authors, 2022-09-21

Re: [PATCH v3 net-next] docs: net: add an explanation of VF (and other) Representors

From: Jonathan Corbet <corbet@lwn.net>
Date: 2022-09-20 13:08:41
Also in: linux-doc

Edward Cree [off-list ref] writes:
On 06/09/2022 10:29, Bagas Sanjaya wrote:
quoted
I think by convention, footnotes should be put on bottom of the doc.
Hmm, a quick and unscientific sample of Documentation/ suggests that
 many/most existing examples put the footnote shortly after the
 reference or at the end of the section, roughly as I did here.  I
 looked at five rST files found by "grep \[#\]_" and all of them had
 the footnote body close to the reference.
The placement of the footnote text in the generated output is up to
 the stylesheet / renderer, of course.
We certainly have no established convention in this area as far as I
know, and I'm not convinced we need one.

Bagas, could I ask you please to focus a bit more on doing useful work
and less on telling others how they should be working?

Thanks,

jon
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help