comment on

With that level of documentation, almost anybody could understand what the code is trying to do.

I think that is the OP's point and have no idea why anyone would want to argue that the goal of very easily understood code is a bad thing?

However the documentation is pandering to people who do not have the capability of writing code at the expense of those who do.

Dude, at any company, school, or hobby group there are going to be programmers of varying skill. You may argue for or against Literate Programming but I am inferring your argument here is that you want to jealously guard your code and not let those people be able to figure it out. People that code less well than me may well deserve explanations and mentoring and not rude dismissal, got it?

In reply to Re^2: An Introduction to Literate Programming with perlWEB by Anonymous Monk
in thread An Introduction to Literate Programming with perlWEB by adamcrussell

Are you posting in the right place? Check out Where do I post X? to know for sure.
Posts may use any of the Perl Monks Approved HTML tags. Currently these include the following:
<code> <a> <b> <big> <blockquote> <br /> <dd> <dl> <dt> <em> <font> <h1> <h2> <h3> <h4> <h5> <h6> <hr /> <i> <li> <nbsp> <ol> <p> <small> <strike> <strong> <sub> <sup> <table> <td> <th> <tr> <tt> <u> <ul>
Snippets of code should be wrapped in <code> tags not <pre> tags. In fact, <pre> tags should generally be avoided. If they must be used, extreme care should be taken to ensure that their contents do not have long lines (<70 chars), in order to prevent horizontal scrolling (and possible janitor intervention).
Want more info? How to link or How to display code and escape characters are good places to start.


P is for Practical
	PerlMonks