Re: [PATCH v2 2/2] docs: driver-api: virtio: virtio on Linux

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On 8/8/22 16:06, Ricardo Cañuelo wrote:
>> -[1] Virtio Spec v1.2:
>> -https://docs.oasis-open.org/virtio/virtio/v1.2/virtio-v1.2.html
>> +.. [1] Virtio Spec v1.2:
>> +   https://docs.oasis-open.org/virtio/virtio/v1.2/virtio-v1.2.html
>>  
>> -Check for later versions of the spec as well.
>> +   Check for later versions of the spec as well.
>>  
>> -[2] Virtqueues and virtio ring: How the data travels
>> -https://www.redhat.com/en/blog/virtqueues-and-virtio-ring-how-data-travels
>> +.. [2] Virtqueues and virtio ring: How the data travels
>> +   https://www.redhat.com/en/blog/virtqueues-and-virtio-ring-how-data-travels
>>  
>>  .. rubric:: Footnotes
> 
> Is that the preferred way to do it? I didn't find any guidelines about
> it and the existing docs don't seem to settle on any specific
> style. Personally I prefer to keep it as it is in the patch because I
> like the bibliography references to look different than footnote links
> ([] vs superscript).
> 

I think the citation syntax is better suited for this case of external
references mentioned in a documentation.

-- 
An old man doll... just what I always wanted! - Clara



[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux