Cisco Command Reference - Serious Concerns

From: Marko Milivojevic <markom_at_ipexpert.com>
Date: Fri, 26 Mar 2010 02:28:12 +0000

Everyone,

I have been reading command references in v15.0 tree in the past few
days (some of you who are my "fans" on Facebook may have noticed, as I
have "spot the errors" quiz going on) and I have reached the point at
which I am seriously concerned. Seriously, seriously concerned.
Configuration Guides and Command References are the only documents
available in the lab - if these are wrong (and they ARE), how are we
supposed to solve issues? I mean, other than have them waived. So
frustrating.

The amount of _serious_ errors in that documentation is STAGGERING.
Now, mind you - I'm not talking about silly little things in obscure
parts of the documentation. I'm talking about, for example, BGP
command reference where I'm hard pressed to find a command that
doesn't have an error in either syntax description, usage guidelines
or examples provides (these are especially horrid). I am so surprised
- it didn't use to be so bad.

Here's just one (benign) example: Go to "ip prefix-list description"
Command Reference. Tell me if you see something wrong there.

I'm semi-afraid to even look into Configuration Guides in fear what
I'm going to find there.

--
Marko Milivojevic - CCIE #18427
Senior Technical Instructor - IPexpert
YES! We include 400 hours of REAL rack
time with our Blended Learning Solution!
Mailto: markom_at_ipexpert.com
Telephone: +1.810.326.1444
Fax: +1.810.454.0130
Web: http://www.ipexpert.com/
Blogs and organic groups at http://www.ccie.net
Received on Fri Mar 26 2010 - 02:28:12 ART

This archive was generated by hypermail 2.2.0 : Thu Apr 01 2010 - 07:26:36 ART