🕷 zenspider.com

by ryan davis



sitemap
Looking for the Ruby Quickref?

"Do the Simplest Thing That Could Possibly Work" applies to more than code

Published 2008-08-23 @ 15:24

Tagged ruby, thoughts

Wilson and I just sat down and stripped a lot of nonsense out of gitjour, making it a plain hoe-based project. Here is the gist of it in one command

  % rake check_manifest                                                                                               
  --- Manifest.txt	2008-06-01 09:31:16.000000000 -0700
  +++ Manifest.tmp	2008-08-23 18:34:54.000000000 -0700
  @@ -1,25 +1,8 @@
   History.txt
  -License.txt
   Manifest.txt
   README.txt
   Rakefile
  -config/hoe.rb
  -config/requirements.rb
   bin/gitjour
   lib/gitjour.rb
  -lib/gitjour/application.rb
  -lib/gitjour/version.rb
  -script/destroy
  -script/generate
  -script/txt2html
  -setup.rb
  -tasks/deployment.rake
  -tasks/environment.rake
  -tasks/website.rake
   test/test_gitjour.rb
   test/test_helper.rb
  -website/index.html
  -website/index.txt
  -website/javascripts/rounded_corners_lite.inc.js
  -website/stylesheets/screen.css
  -website/template.rhtml
  
  % rake check_manifest | patch -p0                                                                                     
    patching file Manifest.txt

Now, the rakefile is a plain hoe-based Rakefile and you can read it and understand it. There are no extraneous files in lib. There are no script files, setup.rb, extra tasks that don’t do anything that hoe doesn’t already do… I just don’t get why anyone needs all that. I don’t quite think the above list really conveys how much simpler the setup is:

  History.txt
  Manifest.txt
  README.txt
  Rakefile
  bin/gitjour
  lib/gitjour.rb
  test/test_gitjour.rb
  test/test_helper.rb