Skip to main content

Your code is not a project

Language matters, just as saying the wrong word to the wrong person can leave you with one less front tooth, so too can the incorrect use of language in general create a cascade of confusion that pervades an entire industry.

One of my pet peeves about the use of language in the software arena is the use of the word "Project". This usage as far as I know goes back to IDEs grouping software artifacts as projects. The notion of a project as the top level organizing construct for software projects (see what I did there?) is now a de facto standard. One problem with this is that it is a complete misuse of the notion of a project. A project is not a thing, it is a process! A project has (or at least should have) a well defined start and end.

As a process, by its very nature, its essence is vague. So when something whose essence is precise (software) is called a project it leaves the reader wondering exactly what is being described. Whenever I come across a documentation describing a piece of technology and then goes on to describe some top-level construct of its configuration as a "Project", I am left wondering exactly what this entails. In other words giving the top level construct its proper name would allow a reader to know immediately what is being described, calling it a project means I need to unwrap its meaning somewhere else.

For instance in designing Hivemind I deliberately stayed away from creating any top level construct that could be considered a "Project". Instead there is an application (a thing), then there is a Task/Project management feature which can be used to actually manage a project. In this way the application is just a component of some project (it could belong to more than one project), the application (or applications) are mere artifacts of the project, they are not the project itself. Now you may well need to organize a group of artifacts into some higher order category or construct, but this still won't be a project :)

The words you use for things (especially complicated things like software) often becomes an anchor for how you think about those things, so while it may seem harmless to mislabel things, there can be real negative impact over time. At the very least the rampant misuse of the term project within software leads to what I call "low grade" confusion.

#TGIF

Comments

Popular posts from this blog

Intelligent Workspace: Managing your AWS Cloud Console via AI

Continuing in our series on the "Intelligent Workspace" as an alternative the the chatbot form factor, we have added another demo showcasing the versatility of the environment.

Where do we go from here? Some thoughts and speculation.

A lot of technologist are rightfully fretting about what the future holds for tech careers, especially in software developer roles. Perhaps it is time to think less about what tab-tab-go programming would mean for the future of developer roles and rather how those existing skill-sets could be leveraged in an AI world. There is tremendous potential in reorienting technologists from a focus on churning out the next app from an IDE and towards thinking in a more holistic manner about how to leverage what already has been built out both in terms of software and infrastructure. The past 30 yrs or so of the tech industry has been a ginormous build-out of technological capability. We in the industry may not have seen it that way since we have been the ones engaged in the build-out process. In other words we have seen the build-out primarily as just our jobs, and less as a process perhaps with a terminal date. I wouldn't go so far as saying the build-out is complete by any means, but it s...

Human + Bot Collaboration via Automated UI Generation Part 2

Today we demo a simple expense reporting application that is generated on the fly by AI and used by a human...call it Just-In-Time (JIT) app creation.