in reply to Draft of CGI::Application Tutorial -- RFC

Looks good, but you assume that your reader already wants to use CA. What if they are looking for both a tutorial and the rationale why they should shift from their current methods? Re: CGI::Application - why? may be be helpful here.

My criteria for good software:
  1. Does it work?
  2. Can someone else come in, make a change, and be reasonably certain no bugs were introduced?
  • Comment on Re: Draft of CGI::Application Tutorial for review

Replies are listed 'Best First'.
Re^2: Draft of CGI::Application Tutorial for review
by bradcathey (Prior) on Jul 16, 2008 at 19:45 UTC

    dragonchild, yeah, I assume they will already be sold on C::A, so maybe I should just reference your excellent nodes if they are still unsure. My rationale section is a little weak, I admit, but more directed at coders like myself. Maybe the rationale part should be dropped altogether.

    —Brad
    "The important work of moving the world forward does not wait to be done by perfect men." George Eliot
      If you want to drop it, that's fine. At least reference good rationales and say something like "I assume you're have already decided. If you haven't, go here, here, and here."

      My criteria for good software:
      1. Does it work?
      2. Can someone else come in, make a change, and be reasonably certain no bugs were introduced?