Re: [PATCHv3 net-next 01/10] docs: bridge: update doc format to rst

[Hangbin Liu <liuhangbin@gmail.com>]

On Tue, Nov 28, 2023 at 02:46:09PM -0800, Stephen Hemminger wrote:
> On Tue, 28 Nov 2023 16:49:34 +0800
> Hangbin Liu <liuhangbin@gmail.com> wrote:
> 
> > The current bridge kernel doc is too old. It only pointed to the
> > linuxfoundation wiki page which lacks of the new features.
> > 
> > Here let's start the new bridge document and put all the bridge info
> > so new developers and users could catch up the last bridge status soon.
> > 
> > In this patch, Convert the doc to rst format. Add bridge brief introduction,
> > FAQ and contact info.
> > 
> > Signed-off-by: Hangbin Liu <liuhangbin@gmail.com>
> 
> Should also reference and borrow definitions from the IEEE 802.1D standard.

Hi Stephen,

Do you mean to use the definitions from the IEEE 802.1D in the doc?

Something like:

The IEEE 802.1D standard defines the operation of bridges in computer networks.
A bridge, in the context of this standard, is a device that connects two or more
network segments and operates at the data link layer (Layer 2) of the OSI
(Open Systems Interconnection) model. The purpose of a bridge is to filter and
forward frames between different segments based on the destination MAC
(Media Access Control) address.

Thanks
Hangbin