Archive for category Soap Box

Reading code Vs searching code

Modern IDEs now allow you to search for a class or a file and go to it from the search results. On my last few projects I’ve seen developers using this feature almost exclusively rather than navigating their code tree. This is a very nice feature that I really enjoy using but does it have a dark side?

I’m an old school hacker and I like to know how my code is structured – its packages, dependencies, web root folders, output folders for the IDE and for automated build scripts, etc. I’ve always felt that this gave me a bigger picture than just “insert code here”. I tend to analyze how the bits of code or classes that I am writing (or reading) fit into the overall structure, where they go, what packages / components / modules / assemblies my application has.

It is interesting that on projects where code navigation by search is the norm I come across weird / circular dependencies between packages, classes in packages that do not really fit together (at least in my mind), and integration tests for endpoints that require the wiring of the entire application to work. My initial feeling is that this is a symptom of developers who may not yet be experienced enough to see the big picture shape of their evolving application, and/or of an application layout/design that does not provide any affordances to developers to indicate where they should put their code.

What’s the point I’m trying to make here? That’s a tough question. I’ve been debating with myself for a while whether I should even blog about this, whether this would sound like a rant, or whether this would be helpful at all. In the end as a software craftsman I decided to simply put this out as a cautionary note and a plea to keep a watch out for code that is frequently searched but infrequently read. It smells …

Tags: , , , ,

Concept To Cash Every Week

Turning on a sixpence – No excuses: Concept To Cash Every Week. Just saw this on InfoQ and it blew my mind. This is what I’m talking about when I mean that details matter and that there has to be a better way to deliver value to a customer.

Have got to try the Pomodoro technique on my current project to see if it can improve pairing between developers (er, mostly between me and whomever is unlucky to be pairing with me).

Value fetishism Vs technical debt – something to remember the next time somebody wants to argue that we can delay dealing with technical debt.

Tags: , , , ,

Asynchronous HTML and HTTP

This post is to remind me that the next time that I am asked to consider using AJAX on a project to actually have a more careful think about the project’s design and user interaction requirements. If I take the time to look at what I really need to retrieve dynamically then will AHAH do a better job more simply than AJAX & DOM manipulation? Will it make my application easier to test?

No great insights, rather than a prompt to ask more questions.

Tags: , ,