Re: [MIB-DOCTORS] AD review of draft-ietf-adslmib-vdsl2-06.txt

"Romascanu, Dan (Dan)" <[email protected]> Tue, 30 Sep 2008 10:08:10 +0200
Newsgroups gmane.ietf.adslmib
Message-ID <EDC652A26FB23C4EB6384A4584434A04FD8ED3@307622ANEX5.global.avaya.com>
 

> -----Original Message-----
> > 
> > E7. The text in the DESCRIPTION clause of the MIB module duplicates 
> > text in the Overview section. No need for both, actually 
> here I think
> that
> > the better place is in the overview, but the main thing in 
> my view is 
> > to eliminate one of them to reduce the length of the text
> > 
> I hesitate to see a blanket one-or-the-other decision.
> 

My comment was not aiming towards an 'one-or-the-other decision'. If it
sounded like this my mistake. I actually believe its good to have such
key explanatory text in both the document text sections and in the MIB
DESCRIPTION clauses, but the full text needs not be duplicated. One of
the sections would include the full text while the second would refer
the first. 

Dan