comments. (Re: key() Re: Saxon VS XT)

[Paul Tchistopolskii <paul@xxxxxxx>]

----- Original Message ----- 
From: <v.rudowitsch@xxxxxx>

> Paul Tchistopolskii <paul@xxxxxxx> am 07.08.2000 16:58:13
> 
> > I think it is very bad approach to 'solve' the readability problem
> > with writing the comments.  Code should be self-documenting.
> 
> Well. I supose you can understand "how" but I bet you cannot
> find the answers on the questions "why?" and "for which purpose?"

As I told, M'r Kernighan's book explains 'why'.

> > I suggest reading the latest Kernighan's book  ( It is
> > "The Practice of Programming" ) on this subjest.
> > I think we could trust to his (huge) coding experience.
> > He says that teaching students to 'write more comments'
> > is a bad practice and he also explains why.
> 
> Don't mix (a) teaching (b) students with developing real projects.

Page 27. "Students are taught that it's important to write comments.
Professional programmers are often requierd to comment their code"

Yes, poor Mr. Kerginghan is mixing it this way.

> I'm really confused about XSL readability.

This is because  it is XML.  Check XSLScript notation. It is much more 
readable and could be improved.

Rgds.Paul.



 XSL-List info and archive:  http://www.mulberrytech.com/xsl/xsl-list