On Versioning (or how the simplest thing can save you from the hardest pain)

Been there, know the feeling...

Long titles aside, this is no flashy post. Some will even find it a bit boring, but if at least one can learn anything from it, I will be happy. The motivation for it comes from an often overlooked issue. I now must tell how a work day can eventually turn out:

A freelance artist we are working with found this really strange and annoying crash bug in the LevelEditor. One point listed in the Luis's standard procedure manual when working with bugs says "first, check the logs, see if anything looks strange there", next one states: "try to reproduce, and work your way on from there". Happened that the logs looked alright, and no one in the team could reproduce the bug in their machines, me included. So neither of these points threw any light into the issue.

It started to look like I was staring at one of those errors that no one wants to deal with, caused by hardware incompatibilities or similar übernice stuff (oh boy).

A new log seemed to make Luis happy, showing some strange error when loading a temporary file. It warned that the file the editor tried to read hadn't been even created. This might sound like hint... but the way the editor works (it checks if the file exists before trying to read) certainly told me that it could not be possible. Frustration++ now (or for the non C speakers there, Luis starts to lose his temper a bit).

After a while of step-by-step execution debugging, unsuccessful thinking about the cause and some other shooting in the dark, a new log came in to my hands and, while it looked alright, it stank of "I fixed this warning thing like three months ago". Turns out that the freelancer was using a dusty old version. He updated and bug gone. Gñe... now I want my sanity back.

This longish story confirms a couple things:
- You must never assume your users have the latest version when they complain about some bug.
- You definitely need a way to identify what version they are running without needing to ask them.

One might think I'm playing Captain Obvious here, but the same kind of situation described above happens a lot of times. It is actually strange to see no new messages for a while in our tech support forum. And even stranger if they are about stuff we have never seen before. Most of the time they are already solved issues, and the solution for them is as easy as updating to the latest patch.

So, after learning this nice lesson, I made a little program that is called by the IDE on the pre build event, and updates a build-ID string (in the form of yyyymmddhhmmss, with y - year, first m's - month, d - day and so on... basically a timestamp of the moment the thing was built) that will then be hardcoded in the engine and apps, and appear at the first line in logs. I am pretty sure there already are better solutions out there for this kind of stuff, but I felt like doing it before any googling, and it didn't take long, so no big deal. At least it might save me from having to buy a little suit:
Our Random Crash Simulator 1.0, feels just like crashing for real!

That's enough for today. Remember to take care, and always version your stuff!
Also, merry Christmas and happy holidays everyone!

Comments

Post a Comment

Popular posts from this blog

F is for Femanx and Forlarren

Image
Back on July 1st, I blogged about the alien race known as the Femanx that caused onto Porphyra. It you didn't read it you can find the entry here . I believe I called them Femiax but I believe that name is closed content so in the final Races of Porphyra and Lands of Porphyra they will be address as Femanx. The other race that we have worked up for the letter F is the forlarren. Forlarren are the unfortunate offspring of demonic forces and nymphs. They are a very troubled race. We first worked with the folarren as a playable race back in Monstrous Races: The Second Wave and they turned out something like this. FORLARREN RACIAL TRAITS (0 RP) +2 Dexterity, +2 Wisdom, -2 Intelligence: Forlarren are graceful and intuitive, but possess only a low cunning that serves their cruelty. (2 RP) Fey: Forlarren are of the fey type. Forlarren possess no racial hit dice and exchange the features of their fey type for the class features of a PC or NPC class. (0 RP) Medium : Forlarren are Medi...
Read more

Megadungeons...

We need more megadungeons for the Pathfinder Roleplaying Game. There is Dungeon-A-Day, obviously and Paizo has just released Dungeons of Golarion (but its more of an overview). We need a classic megadungeon You know the kind... It doesn't have much in the way of plot or even make a lot of sense from level to level but it does have: - pathways to the darklands - prisons for eldritch demons - ancient ruins - lost civilizations - legendary weapons - unexplainable magic (lost magic) - mines - slave pits - elemental nodes - water-filled passages - mazes - one way doors (heck secret doors) - traps - haunted levels - classic monsters (ropers, trapper, mimics, otyughs [especially otyughs], owlbears) - dragons - monsters too big to have ever fit down those hallways. - artifacts A classic megadungeon with everything wrong and right about it. Who is with me!
Read more

Forest of Gora

The Forest of Gora sits between the kingdoms of Illaya and Grismor and serves as their border. Trade routes circle either side of the far stretching forest. Outposts can even be seen within sight of the forest, but none are ever directly next to it. Both kingdoms have learned nothing built near Gora will last the season without being ransacked or razed by those living in it. Both nations have tried on numerous occasions through the generations to lay claim to the land, either by force or in cooperation. Ill prepared for the guerrilla tactics of those that reside in it, they were held back every time. When the native occupants took out their building hostility on the private trade caravans that passed near their borders a quick, unofficial truce was quickly made with the impending threat of economic collapse a lack of trade would cause. Ecology Much of the flora and fauna of Gora is what one would expect from a temperate forest. A mix of broadleaf and evergreens provide a balance of wax...
Read more