Re: [virtio-comment] RE: [PATCH v12 10/10] virtio-net: Describe RSS using rss rq id

["Michael S. Tsirkin" <mst@redhat.com>]

On Wed, Apr 05, 2023 at 01:02:24PM +0000, Parav Pandit wrote:
> 
> 
> > From: Michael S. Tsirkin <mst@redhat.com>
> > Sent: Wednesday, April 5, 2023 5:18 AM
> 
> > following format for \field{command-specific-data}:
> > >  \begin{lstlisting}
> > > +struct rss_rq_id {
> > > +   le16 vqn_1_16: 15; /* Bits 1 to 16 of the vq index */
> > 
> > Do you want to then call this vq_index_1_16 ?
> Yes. will change.
> 
> > And in the comment I would just write virtqueue index.
> > 
> Why do you prefer longer to name here instead of abbreviation?

Eschew abbreviation is standard advice for writers.
Full names reduce the cognitive load - reader has less terms to
remember to be able to understand the spec.

-- 
MST