Weblog entry #85 for Steve

Behind the scenes...
Posted by Steve on Sun 5 Mar 2006 at 12:31
Tags:

I've been writing less about the code behind the site for a while, so heres a brief recap of what has been going on recently.

Mostly the changes have been to improve the performance, and to tidy up a few ropy areas in the code.

There was one important bugfix: now RSS comment feeds on polls work correctly.

I discovered the Test::Pod Perl module, which allows you to test that your inline documentation written in pod ("plain old documentation") is valid. This means that the auto-generated code documentation is now correct, and adds some more tests to the site test suit.

The site code itself is looking good now, I've finally gotten rid of a couple of files which didn't fit into a nice structure.

The actual installation instructions / code documentation is a bit ugly still - mostly because I'm pretty sure that nobody wants to actually use the code on a site of their own. (Having said that there is documentation, and releases are made regularly.)

I think the biggest visible changes at the moment relate to the site-searches, both article searchs and tag searches. Now these two different search types share a common result format, and both match the look and feel of the main site.

Anyway .. that was a pretty link-intensive entry.

I'll try to record more about what I do behinds the scenes in the future, as that was what this weblog was supposed to be about! In the mean time you can spy upon all the CVS commits I make via the timeline...

If there is anything you'd like to see changed about the layout, features, or way the site works .. feel free to suggest it.

 

Comments on this Entry

Posted by ajt (81.6.xx.xx) on Sun 5 Mar 2006 at 22:50
[ Send Message | View Weblogs ]
It's not perfect, but Damien's "Perl Best Practice" is a very good book for managing Perl projects. It covers all sorts of stuff, very good read.

[ Parent | Reply to this comment ]

Posted by Steve (82.41.xx.xx) on Mon 6 Mar 2006 at 01:34
[ Send Message | View Steve's Scratchpad | View Weblogs ]

I like to think I'm a competant developer, although these days I mostly consider myself a "sysadmin who programs" rather than "a programmer who sysadmins".

Most of the best practises I've seen I tend to follow when I'm doing serious work, the obvious things like:

  • Making releases, to make sure i'm not missing files.
  • Using revision control of some kind.
  • Trying to write appropriate documentation.
  • Using consistent indentation/formatting. (I dont much care what I use when working on other peoples code - but it all must be the same, and match.)
  • Designing interfaces appropriately when working with OO.
  • Writing and using test suites/test cases.
  • Writing plans of how I'm going to implement things.
  • Having seperate production and testing environments.
  • Always looking up errors on google before asking other people

Of course for scratch code these things go out of the window .. as you'd expect ;)

I think I could safely say that all the code running here follows those guidelines pretty thoroughly.

[ Parent | Reply to this comment ]

User Login

Username:

Password:

[ Advanced Login ]

Register Account

Quick Site Search