UPDATE - this was meant to be a reply to the first comment on this post.

What is interesting is to see the results of programs built in the opposite order.

1) Write some code.

2) Write some tests because your users have told you your code is breaking.

3) Write some documentation so your users can understand the app, maintainers can maintain, and you can figure out what you have done here.

This approach is invariably faster to market, and also great a deal more prone to failure and a high incidence of defects. Having used both approaches, I prefer the original order of docs, tests, code, especially when additional requirements arise, because the total cost of development is lower, and the product quality is higher. That documentation is a contract between you and the user.

In reply to Re: How to write programs? by redhotpenguin
in thread How to write programs? by artist

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post, it's "PerlMonks-approved HTML":


  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.