Archive for September, 2004

@author tags; help or harm?

Friday, September 10th, 2004

A subject that has come up from time to time at Apache is whether the Java projects should use @author tags or not. The ASF Board currently recommends that no @author tags should exist, but does not enforce such a thing. Their reasoning is firstly on legal advice, and secondly based on occasions when @author management has become a childish practice.

The working practice was that if you made a notable change to a class, you add yourself to the list of @authors at the top. It’s a practice I’ve rarely followed to be honest as I think I rate notable change at a much higher level. My belief is that @author shows the person(s) who are the designers/owners of the code, not just coders.

Personally I’m fine with the ASF recommendation as humility is good for people, but it does mean I’ll someday (if recommendation applied) have to spend more time explaining to people that I have no clue about lang.builder.StringBuilder :)

Roller tweaks

Thursday, September 9th, 2004

Couple of tweaks so far to Roller.

First off, I wanted to have bookmark links to images from other sites, ie) the bbc image.
Secondly I didn’t like the referers section, it was too noisy, so I’ve put a unique-ish filter on it.

Must get a dev server before my wife kills me for the constant bounces of our blogs :)

MT->Roller….

Wednesday, September 8th, 2004

The move from MT to Roller is ‘complete’. It got a nice bump when the machine running the Moveable Type blogs was infested with rootkitters, and had to be turned off.

I say complete to mean that it’s just getting started :)

I think all the MT data is happily in, and now it’s time to start adjusting the look and feel and integrate it more into where I want to go. However, no reason why it can’t leap into service now.