To all my readers: Thanks for reading. Have a great Christmas holiday season and wishing you all a prosperous and successful 2008.
Archive for December, 2007
The Immortal Hamburger
Published Wednesday, 19 December 2007 health , Life ClosedTags: fast food, food, health, Life, McDonalds, preservatives
The PHP Advent calendar is shaping up nicely so thanks to all the guys who are contributing. The latest entry by everyone’s favourite PHP speaker, Terry Chay, is a cracker on web security. Which is slightly interesting given that he uses wordpress for his blog and Ed Finkler (Author of PHPSecInfo) is always giving him grief for that.
Thanks Terry, great article.
WordPress tagging
Published Friday, 14 December 2007 Open Source , Software 1 CommentTags: PHP, tags, wordpress
I love the new WordPress tagging but there seems to be a slight bug in it.
The tags are comma separated and then ordered into alphabetical order but the commas don’t move when the tags are reordered, leaving a comma at the front
Surely I thought this would be as simple as explode, sort and implode.
Thanks.
Congratulations to SDN and all the team for surpassing the one million members mark.
Documentation starts in the kitchen and ends with your brother
Published Friday, 7 December 2007 ABAP , Development , PHP , Software ClosedTags: Advent day, Development, documentation, PHP, Software
I am all for good documentation. Whether I do it myself is something that I will leave for others to judge me on. I have had a ‘documentation is like labeling your power sockets’ post ruminating in the back of my mind for a while now and then I read this.
Elizabeth Naramore has added to Chris Shiflett’s PHP Advent Day calendar with an excellent piece on documentation.
She makes some excellent points on how documentation can be like telling a stranger to putting the dishes away, how it helps you examine your code, how it keeps you mindful of portability, how it will save you debugging time and how it will save your ass.
I like the anecdotes.
I have my own. As I said, I have been ruminating on this thought for a while but for me documentation is like well labeled power sockets. Power cables are an interface. They interface your stereo, laptop, dvd etc with the power. The problem is, just like parameters, power sockets all look the same. A little blue label can go along way.
I am sure that you have never had get behind some really inconvenient cabinet and change a video over for a dvd and you had no idea which socket was safe to pull out. Whoops, you just pulled out the TV.
I have to do this all the time. I am always pulling out my laptop and moving it somewhere else. Office to client, back again, into power strips neatly organised with 3 neat little friends it can hide next to, retrieving it from a tangle of power cables printer cables and usb cables.
It might look a bit silly but when you go to pull out your power a little blue sticker can save you a whole lot of time.
Ditto for documentation. Sure putting that extra little comment in there looks a little silly but 6 months from now you or the guy who comes behind you is going to appreciate it.
I met someone the other day at and we started comparing notes about all the projects we had worked on. ‘Ahh’, she says. ‘I remember your work from client such and such a project. You left good comments.’
Sometimes your brother can be your best friend.
Anyway that’s enough serious stuff for a Friday night, I have a friend coming over with his X-box and I am going to have to find some power sockets for him.