further CBQ/tc documentation ds9a.nl/lartc/manpages

[bert hubert <ahu@ds9a.nl>]

On Sat, Dec 08, 2001 at 02:20:20PM -0500, jamal wrote:

> > The parts of the table of contents that document stuff in the kernel not
> > documented elsewhere:
> 
> "not documented elsewhere" comes out rude. Werner and I (and even
> Alexey when he was in the mood -- and i have seen some good documentation
> by other people as well) have spent numerous hours documenting, presenting
> and answering questions on mailing lists at times

True. I should have worded that better but I lost sight of politeness due to
my great enthusiasm at finally understanding everything. Some parts required
literally *hours* of digging through sources and disembodied slides -
presentations lose something without a speaker.

> Sample docs that i was personally involved in:
> ftp://icaftp.epfl.ch/pub/linux/diffserv/misc/dsid-01.txt.gz

These days I understand this document, but I didn't used to. That might be
because I'm thick, though.

> You need to introduce the big picture to the user.
> and what is wrong with the definitions used in
> http://www.davin.ottawa.on.ca/ols/img10.htm that forced you to introduce
> your own?

I've since moved to this terminology. Please also see the manpages I'm
writing at 
                        http://ds9a.nl/lartc/manpages


> Actually, the big picture is:
> http://www.davin.ottawa.on.ca/ols/img9.htm
> Also
> http://www.linuxjournal.com/article.php?sid=3369
> (was written in 98 but got published in 99)

Google is surely to be praised - I had found all these links already. But to
summarize: stuff is out there.

> [My complaints about your style is you often are trying to present facts
> by using opinions. For example despite a lot of effort in the past to
> explain ingress qdisc to you in the past and, pointing you to very good
> documentation from CISCO you still ended using your opinions on what you
> thought it should be;->

I really didn't understand how everything worked back then, sadly. I do now,
hopefully.

> My scanning of the document shows opinions still posing as miscontrued
> facts. It is improving compared to what i saw last when we discussed ingress.
> Let me clarify one thing in this email; i'll read what you have later.

Some stuff remains from that time, am working on removing it. My current
efforts is writing the manpages and getting them 100% right and devoid of
opinion.

Once they are finished & reviewed, I'm 'backporting' the insight to the
HOWTO, which will then lose a lot of content and instead refer to the
manpages.

> Lets start by your description of TC_PRIO and TOS mappings etc:
> Your descriptions of these values is insufficient. Consider this a
> tutorial and reword it as you wish but please avoid opinions.

Will do, it makes sense now.

> Look at RFC 1349 for typical values used by different applications
> Then of course note that RFC 1349 is obsoleted by RFC 2474 (yes, you can
> weep);

That confused me greatly, yes.

> What i think would be useful for you to do is describe some of the vlaues
> used by some applications (RFC 1349 cut-n-paste job would help).

Thanks. I'm working on making the HOWTO more factual and the manpages 100%
factual. I'm always happy with critiques.

Regards,

bert

-- 
http://www.PowerDNS.com          Versatile DNS Software & Services
Trilab                                 The Technology People
Netherlabs BV / Rent-a-Nerd.nl           - Nerd Available -
'SYN! .. SYN|ACK! .. ACK!' - the mating call of the internet