Re: [Idr] [RTG-DIR] Rtgdir early review of draft-ietf-idr-bgp-car-02

[Ben Niven-Jenkins <[e-mail]>]

Hi Susan,

> On 1 Aug 2023, at 17:36, Susan Hares <[e-mail]> wrote:
> 
> Ben: 
>  
> Can you provide additional detail regarding your concerns? 

Sure. The Introduction is only 4 lines before the document starts defining terminology and the section after that (1.2 illustration) assumes pre-knowledge of what Color-Aware Routing is.

As someone without any pre-knowledge of color-aware routing or intent-aware paths it was quite difficult to form an idea in my head of what the big picture into which BGP CAR fits is.

I am suggesting including some additional introductory text that provides a bit of background and context and how BGP CAR fits into the bigger picture before the document starts getting into the gritty details of BGP CAR.

HTH
Ben

>  
> You state: 
>  
> “The only suggestion I would have is to provide a short overview introducing BGP CAR and
> color aware routing before leaping into terminology and the details of the BGP
> CAR SAFI. Expanding the introduction section with an extra paragraph or two
> would be sufficient.” 
>  
> Sue Hares 
> IDR WG chair shepherd draft 
>  
> From: Ben Niven-Jenkins <[e-mail]> 
> Sent: Monday, July 31, 2023 4:15 PM
> To: Ben Niven-Jenkins <[e-mail]>
> Cc: [e-mail]; [e-mail]; [e-mail]
> Subject: Re: [RTG-DIR] Rtgdir early review of draft-ietf-idr-bgp-car-02
>  
>  
>  
> 
> 
> On 31 Jul 2023, at 20:56, Ben Niven-Jenkins via Datatracker <[e-mail] <mailto:[e-mail]>> wrote:
>  
> Reviewer: Ben Niven-Jenkins
> Review result: Has Issues
> 
> Hello
> 
> I have been selected to do a routing directorate “early” review of this draft.
> https://datatracker.ietf.org/doc/draft-ietf-mpls-rfc3107bis/ <https://datatracker.ietf.org/doc/draft-ietf-mpls-rfc3107bis/>
>  
> Of course I meant https://datatracker.ietf.org/doc/draft-ietf-idr-bgp-car/ <https://datatracker.ietf.org/doc/draft-ietf-idr-bgp-car/> :-)
>  
> Ben
> 
> 
> 
> The routing directorate will, on request from the working group chair, perform
> an “early” review of a draft before it is submitted for publication to the
> IESG. The early review can be performed at any time during the draft’s lifetime
> as a working group document. The purpose of the early review depends on the
> stage that the document has reached.
> 
> For more information about the Routing Directorate, please see
> https://wiki.ietf.org/en/group/rtg/RtgDir <https://wiki.ietf.org/en/group/rtg/RtgDir>
> 
> Document: draft-ietf-idr-bgp-car-02
> Reviewer: Ben Niven-Jenkins
> Review Date: 31 July 2023
> Intended Status: Experimental
> 
> Summary:
> I have some minor concerns about this document that I think should be resolved
> before it is submitted to the IESG.
> 
> Comments:
> The document provides lots of details in the main sections and examples in the
> appendices. I think that is generally ready to be published. The only
> suggestion I would have is to provide a short overview introducing BGP CAR and
> color aware routing before leaping into terminology and the details of the BGP
> CAR SAFI. Expanding the introduction section with an extra paragraph or two
> would be sufficient.
> 
> Thanks
> Ben
>