What is Software Architecture

When people question me about my main interests in software development, or about exactly what I do in my job, I use to say I like to act as a Software Architect, which is a pompous title, and most people don't take it seriously, by finding it is just a job title and not a real role in the development process. Probably most of you who know from inside a software development process know what is the job of a Software Architect, but some ones might not. This week I found this great reference, which explains exactly what I feel to be a Software Architecture, as well as what is the job of a Software Architect. So, that is the answer for what I like to do for living.

Scott Hanselman's 2009 Ultimate Developer and Power Users Tool List for Windows

As I said in my first post, this blog will also serve as a kind of delicious for me, so you will see me posting many references to other blogs' posts. One reference I couldn't let pass is this post of Scott Hanselman's blog: An amazing list of tools for Windows developers and power users. For sure they worth a try.

My Own Code Snippet Formatter

Some weeks ago when I needed to publish code snippets here for the first time, I looked for plug-ins for Windows Live Writer and found two good alternatives, from which I decided to use the simpler one.

After that, I started to build my own code snippet formatter. Only for C# snippets, and using JavaScript, that is far from what I'm used to write.

After some weeks working on it in my spare time, it's finally usable.

It is available here.

But, if you want a true syntax highlight tool, try this one.

Enjoy!

How to define the priority of a bug

Some time ago a tester told me we didn't have a formal criteria to define the priority of a bug, and that the few criteria he know were not easy to use. After some thoughts, we decided to work together to define a criteria that would be good for us.

The result was a compact definition for five priority levels for bug fixes:

• Minimal: A bug is said to be of minimal priority when its occurrence:
• Do not cause any damage to the stored data;
• Do not interrupt the usage of the software;
• Is hard to be observed* and does not bother the user.
• Low: A bug is said to be of low priority when its occurrence:
• Do not cause any damage to the stored data;
• Do not interrupt the usage of the software;
• Is easy to be observed but does not bother the user.
• Normal: A bug is said to be of normal priority when its occurrence:
• Do not cause any damage to the stored data;
• Do not interrupt the usage of the software;
• Is easy to be observed and bothers the user.
• High: A bug is said to be of high priority when its occurrence:
• Causes some damage to the stored data or interrupts the usage of the software;
• Is hard to be observed.
• Maximal: A bug is said to be of maximal priority when its occurrence:
• Causes some damage to the stored data or interrupts the usage of the software;
• Is easy to be observed.

* A bug is said to be of hard observation when it only occurs in extraordinary use cases, it means, in situations that are rarely provoked by the user.

Parsing a Delphi DFM File

Some time ago a friend asked me to help him to parse a DFM file into .NET objects. We tried to find something in the web that does the job but no success, so I accepted the challenge and wrote the parser he needed.

If for some reason you need a DFM parser, or just for curiosity, you can download it from here.

Here is an example of how to use it:

class Program { 

    static void Main(string[] args) { 

        var fileName = @"c:\Unit1.dfm"; 

        var dfmParser = new DfmParser(fileName); 

        dfmParser.ReadFile(); 

        foreach (var node in dfmParser.Nodes) { 

            if (node.PropertyType == "string") { 

                node.PropertyValue = "'Hello World!';"; 

            } 

        } 

        dfmParser.SaveFile(); 

    } 

}

The example above loads this file:

object Form1: TForm1

  Left = 0

  Top = 0

  object Label1: TLabel

    Left = 8

    Top = 40

    Caption = 'Label1';

  end

  object Label2: TLabel

    Left = 48

    Top = 40

    Caption = 'Label1';

  end

end

And rewrites like this:

object Form1: TForm1

  Left = 0

  Top = 0

  object Label1: TLabel

    Left = 8

    Top = 40

    Caption = 'Hello World!';

  end

  object Label2: TLabel

    Left = 48

    Top = 40

    Caption = 'Hello World!';

  end

end

If you find some use for this, enjoy :)

Best Practices for Individual Contribution

Today, in his blog, Scott Hanselman is talking about how to be a good individual contributor.

Whatever it means, what he shows is a good bunch of best practices for how to be a good professional. I was surprised to see how much I agree with his points, and I only did not see me in the situations he describes for the one about twitter, cause I don’t tweet, but yet in this case, I completely agree with the general rule.

Below I’m quoting his points, but you need to see the original post, as there are many good contributions also in the comments section.

• Consciously manage your personal brand.
  • You work here to help the company, but also yourself. No one will manage your “personal brand” except you. How are you perceived? Do you know? Take negative feedback gracefully, and implement change. Rinse, repeat.
• Push the Limits
  • Chris Sells told me once, If you’re not getting in trouble with your boss at least twice a year, you’re likely not pushing the envelope hard enough. Two slaps a year might be the cost for 10 successes. If you’re not moving forward, well, you’re not moving forward.
• Conserve your keystrokes.
  • When you’re emailing a single person or a reasonably sized cc: list, ask yourself, are you wasting your time? Is this a message that 10 people need to see, or 10,000? Is email where you should be spending your time. Actively be aware of the number of people you communicate with , and the relative level of influence. Is a blog post seen by 50,000 more or less valuable than a single email to your skip-level? Only you can answer, but only if you’re consciously trying to conserve your keystrokes. Your fingers DO have an expiration date; there’s a finite number of keystrokes left, use them wisely.
• Don’t give bile a permalink.
  • While you’re on the clock, think about what you tweet and FB. It only takes one bad link to undo a year’s work. Same goes for tweeting product launches before they’ve launched.
• Write down what you’re trying to accomplish and hang it on the wall.
  • Make T-Shirts. Tell your spouse and kids. If you’re working towards a goal, tell people. It’ll keep you honest and it’ll motivate you. Saying things out loud help make them reality.
• Manage Up
  • Are your commitments aligned with your boss and your bosses boss? Do you have visibility into their commitments? If not, ask for them. Make sure your accomplishments are making yourself, and your boss, look good.
• Have a System to Manage Information Flow
  • If you’ve got 1000 emails in your Inbox, it’s not an Inbox. It’s a pile of crap. Have a system, any system, to triage your work. Any item in your inbox should be processed: Do it, drop it, defer it, delegate it. There are no other actions to take. Are you effectively managing your information flow? Try scheduling time for email on your calendar.

Remember, don’t lose the original post.

JQuery Framework

As I don’t work with web development at the moment, and did few things related in the past, JQuery is something completely apart of what I’m used to work with, but at the same time, as I intend to work with it in the future, it is something that interests me a lot.

This month, Luis Abreu is writing a series of posts in his blog that gives a good introduction for that amazing framework and then I decided to post a reference for such posts here, for future use, and for the appreciation of the readers.

I’ll keep it up to date as soon as new posts come up.

• JQuery: getting started;
• JQuery: understanding the JQuery function;
• JQuery: chaining;
• JQuery: getting started with selectors;
• JQuery: more on selectors;
• JQuery: custom selectors;
• JQuery: understanding how selectors are implemented;
• JQuery: working with the wrapped HTML elements – part I;
• JQuery: working with the wrapped HTML elements – part II;
• JQuery: working with the wrapped set – part III;
• JQuery: interacting with the wrapped set – part IV;
• JQuery: working with the wrapped set – part V;
• JQuery: interacting with the wrapped set- part VI;
• JQuery: creating new HTML snippets;
• JQuery: interacting with the wrapped set – part VII;
• JQuery: interacting with the wrapped set – part VIII;
• JQuery – interacting with the wrapped set – part IX;
• JQuery: getting started with events;
• JQuery: more on events;
• JQuery: unbinding with anonymous functions;
• JQuery: one-shot event handlers;
• JQuery: shortcuts for the most used events;
• JQuery: triggering events;
• JQuery: binding handlers for current and future element’s events;
• JQuery: DOM 0 level event model;
• JQuery: DOM 2 level event model;
• JQuery: DOM 3 level event model;
• JQuery: DOM level event model support;
• JQuery: more on triggering events;
• JQuery: more on the triggerHandler method;
• JQuery: common “event pairs” helpers;
• JQuery: utilities functions I – browser detection;
• JQuery: utility functions II – trimming strings;
• JQuery: utility functions – testing helpers;
• JQuery: utility functions IV – interacting through arrays;
• JQuery: utility functions VI – checking if an item is in an array;
• JQuery: utility functions VII – concatenating arrays;
• JQuery: utility functions VIII – creating arrays from other objects;
• JQuery: utility functions IX – transforming arrays;
• JQuery: utility functions X – extending objects;
• JQuery: getting started with effects;
• JQuery: fading elements;
• JQuery: sliding;
• JQuery: running custom animations;
• JQuery: getting started with AJAX;
• JQuery: the $.get and $.post methods;
• JQuery: the $.getJson method;
• JQuery: deferred script loading;
• JQuery: full control with the $.ajax function;

Windows 7 – First Impressions

In setember 2007, I bought my first Mac. A 13” entry model MacBook that cost me, in Brazil, something like US$ 1700,00. It was expensive, but a good price for Brazil.

After that, I sold my 1 year old PC and stopped using windows at home. Only a few times I recurred to Bootcamp to run Windows for some small jobs.

Earlier this year, I started to think about to buy a new Mac, this time a top level MacBook Pro, as soon as Snow Leopard, and maybe a Nehalen upgrade, are available.

Turns out that I put my feet on the Earth, did a cost survey and noticed that now, for the a little more than I payed for my entry model MacBook, I would be able to build a Core i7 PC, almost equivalent to the Mac Pros. It means, I can keep my macbook, that is still good, and build a new system for the half of the price I would pay for a MacBook Pro, and with much more performance.

But if I buy a PC, I’ll not be able to continue using the OS I’m loving, so the issue now is to give up or not of Mac OS X.

Windows XP and Vista are not good competitors, and I don’t like linuxes. Then I remembered Windows 7 RC was out, and decided to give it a try.

After a month using it, I can say Windows 7 is an awesome system. Maybe not so fast and stable as Leopard, but so easy to use and atractive as it. And also, until where I could go with the RC, so much faster and stable than Windows Vista.

The UAC, that everyone uses to disable in Windows Vista, now works fine, it means, only when necessary.

The new task bar is the most impressive of the new features, and it reminds me so much the Mac OS Dock, so I’m loving it. The only downside for me until now is that it is not possible to fix the Recicle Bin on it.

The new window handling functions are good too. And obviously, there are several other improviments through the whole system.

I think this time Microsoft is taking the right way.

Hope it become better until the launch day.

A comparative study of the Java and C# languages

If you search the web for comparisons between the Java and C# programming languages, you will end up finding two great articles, among many others.

The first one is written by Dare Obasanjo, and available in his site 25 Hours A Day. The other, that is not so descriptive but provides great examples, is a code for code comparison available in the JavaCamp.org website.

I’m citing these two great resources because now I’ll post here the final work I did for my System Analysis course, that is also a comparison between such languages.

The main differences between my comparison and the one made by Dare Obasanjo is that the mine tries to use a didactic line, running from the easiest languages aspects to the most complex ones. Also, and a downside for most of the readers of this blog, is that it’s only available in portuguese.

If you speak portuguese, maybe you enjoy!

A comparative study of the Java and C# languages

Replacer

One of the reasons I create this blog is to publish some smart small tools I built to make my fellows lives, and mine of course, easier.

The most useful of such tools is Replacer.

Replacer is a search and replace tool I built back in 2006 when I couldn’t find any such tool in the Internet that could make the job the way we needed.

It is pretty simple to use and its main purpose is to search or replace, at the same time, several one line text blocks in all files that match the given filter criteria.

The main features of Replacer are:

• Filter criteria to include and exclude files;
• Classic search options like case sensitive and whole word only;
• Search or replace several one line text blocks at the same time;
• Possibility to ignore comment blocks;
• Find only the first occurrency of the search text on each file;
• Create backups before to replace;
• Prompt a confirmation before each replacement;
• In the result screen, highlight the word that contains the search text;
• In the result screen, show the number of the row where the text was found.

The main limitations are:

• Only one line text blocks can be used *;
• One line comment blocks cannot be ignored, only blocks with a start and an end mark;
• Not fully tested, maybe it doen’t work with some kind of files;

As said before, it was not tested to become a sellable product, so if you want to use it, you must consider that statement that says it is distributed ‘as is’, offers no warranty and must be used by your own risk.

Replacer.zip

Hope you enjoy!

* I’ve started to work in a version that supports multiple line blocks, but it has introduced some bugs, so I’ll not publish it yet.

First Post

Hi all!

There is a long time since I started to think about to create this blog.

Many things passed thru my mind that made me think: “It is a good thing for a blog post”, but I didn’t have a blog.

Why didn’t I simply create a blog and post such things?

The reason was the doubts. What blog engine to use? Restrict the content to tecnology/programming related? Which language to post in? English or Portuguese? And such doubts, among others, made me postpone the blog creation over and over.

Now, in the end of the first work day of my vacations, I decided to put the hands on and create it, using blogspot, restricting the content and posting in english, even though I would be much more confortable writing in my native language.

So that is it. From now on I’ll try to post some interesting articles and comments here.

Hope you enjoy!