software — John Levy Consulting

How to manage a project

August 6, 2013

The essentials of project management in under 500 words

What’s a project?

A project is any endeavor that takes time and involves more than one person. Typically, we don’t call it a project unless it involves at least 3 to 5 people, and then we call them a team.

A project requires communication, collaboration and coordination. A project also usually results in something being delivered to a third party.

Five aspects of managing a project

1. Defining the parameters.

What are the inputs? What are the outputs? What are the rules?

2. Discovering the goals, limits and values.

Goals include requirements for the outputs and other things that you want to have as a result of the project.

Limits include things like how much money you can spend, how much time you have, and who is allowed to do what.

Values include the priorities among time, cost and quality; and what the people in the project want to get out of it.

3. Planning the work

Planning includes setting your own expectations and the expectations of others; and being prepared to deal with unforeseen events.

4. Reporting

Reporting means communicating about progress, problems, resources used, and results delivered.

5. Interacting

Interacting with team members and stakeholders to facilitate, encourage and moderate.

What is a successful project?

A successful project delivers the right outputs on time.

At the end of a successful project, the team is still improving and is ready to take on another project.

At the end of a successful project, we have learned something and improved how we define, discover, plan, report and interact.

How do projects fail?

A project that produces no output or produces the wrong output is a failure. Examples include products that get returned or software that causes problems for the customer.

A project that consumes excessive resources is a failure. A project that does not deliver results in time to be useful or valuable is also a failure.

A project that ends with a burnt out team who cannot take on another project is a failure.

How to head off failure?

Choose and keep the right team. Select people who have needed skills and are good at being part of a team. Remove people who don’t get along with the team.

Limit the scope of the project. Put your job on the line to keep the project down to a manageable size. Break the project into phases to limit the scope of the current work.

Verify correctness of the outputs with the customer. Check the requirements with the stakeholders at the beginning, and verify regularly that what has been done is still needed and expected by the stakeholders.

Iterate at regular intervals. Deliver workable parts of the output in small increments and then re-check the scope and priorities for the next increment.

Listen carefully at all times. Don’t presume anything without verifying it yourself. Tell people when they’re doing something right.

Interested in tiny houses? See Tiny House Design Workshop for a September event in Washington, DC.

Filed Under: Agile Management, Painless IT Tagged With: agile, collaboration, development process, IT development, IT management, IT project failure, management, planning, product development, project management, project management pathology, software

What’s going on inside my computer?

July 23, 2013

We all ask this question now and then, particularly when the computer or its application software is not working as it should. Or at least when it’s doing things we don’t understand.

Our smartphones are no different – they are primarily computers, with some radio communications thrown in to connect them with the world. Of course, those radios include 3G and 4G cell phone bands, WiFi and Bluetooth.

Let’s focus for a moment on what every computer has to deal with inside its “kernel” – the core of the operating system. No matter what else is happening at the application level, here are some of the events and processes going on underneath the apps.

1. Memory management – keeping track of who is using which parts of RAM and ROM (often Flash memory). Not only is there constant competition among the applications for RAM space, the operating system itself has to allocate space for its own processes. Furthermore, applications often are using more RAM space than is actually available in hardware. How is this possible? By using “virtual memory” which means that some of the “space” is actually on disk or in Flash or Solid-State Disk (SSD) memory. Only the active “pages” of an application are actually in RAM, while others are “paged out” to disk.

2. Disk Input/Output (I/O) – whether it has a real spinning disk or an SSD, an operating system has to manage the traffic in and out. Since it takes a lot longer to move data to and from disk that it does to compute anything, scheduling has to happen for multiple such transfers at the same time. This means building queues of pending I/O operations, dealing with retries if there are errors, and cleaning up the queues when they are finished.

3. File System – on top of the disk I/O, an operating system usually provides a file system. This creates named collections of data, allocates space for them on disk, and keeps track of all the pieces of a file. Sometimes it also manages redundant file information (such as RAID or block replication) to guard against data loss.

4. Network protocols – there is a separate protocol for each network, such as GSM phone, CDMA phone, WiFi (to Internet), and Bluetooth. Each protocol has multiple layers of interactions going on. The system has to manage each layer by generating and responding to messages coming and going on the network.

5. Error recovery – not all operations in the computer are successful. Here are some of the ways they can fail.

a. When a transmission over a radio link or a disk I/O operation is initiated, there is always a timer set up that counts down and fires off an interrupt when it gets to zero. The interrupt means that the operation has failed, because it didn’t complete within the allotted time.

b. There are other ways to fail, too. Sometimes, a radio transmission will be garbled. This gets detected when a checksum or other code check finds a mismatch in the message. Then the recovery involves sending a reply message that says, “I didn’t get that last message.” And there are multiple layers of network protocol at which such messaging is being done.

c. The hardware of the computer itself fails. A bit gets dropped in the memory, or a bus from one part of the computer to another part loses a pulse and sends the wrong data. This gets detected when the data is checked and found to be an impossible value (a value that is not normal). In this case, the whole operation has be repeated, or else the program that was running and using this data has to be terminated.

6. Power management – in addition to turning the system on and off, mobile systems, such as smartphones, are actively managing power to various subsystems so as to minimize the load on the battery. Most systems also manage screen brightness (more in bright light, less in dim light) and disk spinning (turn off when not in use).

7. User interactions – A user may be typing on a keyboard, moving a finger around on a touch screen, pressing buttons, and reading what is displayed on a screen. There can also be other attachments, such as fingerprint readers or credit card readers, providing data to the system. There is also sound output and voice input. Determining what the user is asking the system to do may require sophisticated software, including motion detection on the touch screen and parsing the voice input.

To support application software, the system may include “frameworks,” such as a Java language framework, which is a collection of facilities that enable programs in Java to be run using a Java Virtual Machine. And there may be other facilities provided by the system, such as an indexing and search capability for emails, calendar items, address book items, web pages, and files. These require sophisticated data structures to be built and added to whenever a new item arrives in the system.

These are a sampling – but not all – of the activities and facilities in your system. There may be hundreds of thousands of lines of code involved in them. And someone – a team of someones – is maintaining that code as it evolves from generation to generation.

Is it any wonder that software project management – and particularly software lifecycle management – is a critical part of a successful vendor’s technology?

Filed Under: Agile Management, Painless IT Tagged With: applications, complexity, frameworks, kernel, operating systems, protocols, software, software lifecycle management, user interaction

Why do we need so much software?

April 18, 2013

Software is everywhere, but you can’t see it. You know it’s in your phone, your computer, your home appliances and your electric meter, but do you know why? This article explores the reasons for the explosion of software.

Computers have taken over many functions that used to be performed by other equipment and by people. While computers were originally developed to compute, they now control, communicate and manage things that require much more than just “computing.”

Moore’s Law is the term used to describe the geometric increase over the past 50 years of the number of electronic digital circuits that can be placed on a fixed-size piece of silicon. A corresponding decrease in the cost of those circuits has driven the digital revolution – replacing nearly everything that used electrical or electronic circuits with their digital equivalent.

A “digital equivalent” of course is not really equivalent, because it consists of a computer. Each computer, no matter how small or large, includes a processor, memory, and ways of moving data in and out. All of the activity in a processor happens as a result of executing a program – a series of instructions that are stored in the memory. And programs are software.

Managing the activities of a computer requires – a computer. The operating system of a computer is the set of programs that are concerned with managing resources and activities inside the computer. This is not trivial, because programs are constructed of very simple instructions, and there are a lot of resources and lots of activities inside each computer. For example, what happens when data is moved in or out of the computer? Where does it get stored? How does it get checked and how does it get moved to a more permanent location, such as a disk? These are all activities an operating system is concerned with.

Keeping track of stored data usually is done by a file system, which is another part of most operating systems. Turning power on and off for parts of the system that are not used all of the time is another function of system software on, for example, a mobile phone. This extends the battery life.

Furthermore, thousands of conditions can occur while the computer is operating, such as errors in moving data or interruptions due to user interaction (like typing on a keyboard or touching a screen icon). Each condition has to be dealt with in a way that won’t stop the computer.

As computers have become widely used, specialized programs have come to be part of the standard repertoire. Programs dealing with databases (such as a customer list with all of their purchases), audio and video data (such as YouTube videos and podcasts), and photos (such as your smartphone pictures) have become standard requirements for computers that we use in business and at home.

Communications systems – including the Internet – have incorporated computers to manage delivery of data globally; and services such as Google have developed enormous dictionaries of everything on the Internet (and also things like videos and books) that can be searched. The hardware of each of these, while massive and widespread, is dwarfed by the effort put into creating software that keeps them running and delivering the latest services.

Competition between the latest start-ups today is mostly in the domain of software. Delivering new services in the Internet age requires deep understanding of software and how to leverage what was developed by others last week to make something new this week.

Software and the tools for developing it are the context in which the best and brightest of the current generation are expressing their creativity and becoming part of the global economy. You can expect more software from more software designers to result in a lot of unexpected new products and services.

Filed Under: Agile Management, Painless IT Tagged With: computer, file system, innovation, Internet, Moore's Law, operating system, product development, smartphone, software, startup, technologists

Software development – not by PERT alone

April 1, 2013

I have great respect for software developers. Because software is abstract, invisible and runs at extreme speeds, the people who are good at building it have to possess a particular talent at visualization and a willingness to use complex tools.

When software developers become project managers (PMs), they tend to rely on software tools to monitor, control and report on projects, just as non-technical PMs do. The problems that technologists have in management have to do with inexperience in people interaction, including conflict, collaboration and just plain old ability to listen well. If you’re a technologist in management, you can find more ideas on what to do about this in my book Get Out of the Way.

For the rest of PMs, there are lots of good tools, such as PERT and Gantt charts, but simply having good tools will not make your project succeed. Software development projects frequently fail to produce results that the customer or end-user wants. Why?

Here are three factors that contribute to the unruliness of software development projects:

Estimating the effort and time required to complete a task is difficult. Even when reasonable-looking requirements and specifications of a software package are provided, understanding the difficulty of development may require architecting multiple layers and investigating interactions with a complex environment. Since requirements are generally high-level items, and design has to be done at multiple levels, it is difficult to break down the work into “pebble-sized” tasks and then to keep to a schedule with those tasks.

Designing an algorithm often takes experimentation. Engineering a software system requires trying out some things to see if they work, or testing multiple possible ways to implement something to find one with reasonable performance, for example. This aspect of software engineering is so prevalent that Fred Brooks in The Mythical Man-Month advised us to “plan to throw one away.” He meant that at the completion of a complex software implementation (such as an operating system), the designers have learned so much that it is often best to start over and re-implement everything.

Assuring that a software implementation functions properly under all conditions may take as long as the design phase. In fact, you may never be able to prove proper functioning, because testing all combinations of conditions is impossible. At best, using test-automation tools and good intuition about where to look for errors, a software team can reduce the number of bugs at the time of a software release, but almost never to zero.

Scheduling a software project is made more difficult by the fact that additional tasks are always discovered during implementation. This is so prevalent that I learned long ago always to ask “What remains to be done?” in addition to “What have you completed?” You can count on the list of tasks to be done growing during the project.

One of the best countermeasures to all of these problems is to use Agile development methods. Using iterative development with regular demonstrations of working software having incrementally greater functionality will help reduce uncertainty and increase the ability of a development team to adapt to a changing world. It also shortens the time between the initial charter of the project and the point where the customer says, “but that’s not what I wanted.”

Even Agile will not save all projects. To learn more about why not, have a look at these slides, “Why Agile Won’t Fix All Your Problems.”

And good luck. The world needs software, so we all have to keep on trying to deliver it the best we can.

Filed Under: Agile Management, Painless IT Tagged With: agile, development process, IT development, IT project failure, PERT, product development, project management, project management pathology, project management tools, software, technologists

Technical debt and causes of software instability

February 7, 2013

“Technical debt” refers to releasing software products that have significant bugs in them. The cost of removing the bugs after release must be paid if the software is to survive in the long run. So the concept is similar to financial debt: the longer you leave it unpaid, the more you must pay in compound interest.

In a recent interview, one of the authors of the term “technical debt” had this to say:

Most companies don’t have a clue on how to get rid of bugs before release. … they’re acting out of ignorance because they don’t know what they’re doing. … the companies that do know what they’re doing … don’t have much technical debt … because they’re using … defect-prevention, pretest removal, static analysis and inspections, and really good testing.

– Capers Jones as quoted by Joe McKendrick http://zd.net/VjuA38

Evidence of technical debt is all around us: Maintenance efforts that are larger than the development effort on a product suite. Failures that keep occurring in software that has been on the market for years.

**Three false causes for software instability.**

1. Users don’t care

Many products are delivered quickly to an audience that is not very discriminating. For example, if your iPhone app fails once in a while, you aren’t too disturbed unless the failure causes the whole system to stop. And if the app allows malware to infect your phone, you probably won’t be able to tell that it was caused by shortcomings in the design of the app.

But in the long run, people will know whether the software is reliable and secure. So they will drop out from your customer list without so much as a goodbye note. You have a few months to get your product up to a reasonable level of reliability, but you don’t have years.

2. It costs too much to do it right

Everyone knows it is impossible to test all combinations of inputs to a software system. So we depend on educated guesses when testing. And when a product is behind schedule (and what product isn’t behind schedule?), we short-change the testing in order to meet shipment date commitments.

But even though exhaustive testing is impossible, it is possible to have a well-crafted testing plan and to execute the plan in a timely way. Yes, this does require budgeting enough resources for testing. Doing it right saves a lot of headache and lost goodwill later on.

3. We don’t know how.

There is no single accepted set of standards for how to create bugless software, so why try to follow the latest trends? After all, even the biggest organizations (the FBI, airlines, banks for example) have had software projects fail to complete.

But there are management techniques, including Agile methods, that can minimize the risk of a failed project. So there’s little excuse for ignoring the advances that have been made in software development.

**Three true causes for software instability.**

1. It’s complex

As more and more products are designed with software at their core, the complexity of the software tends to get greater generation by generation. This is good, in that the depth of the software leads to more sophisticated solutions. But it also makes for complex systems that are increasingly difficult to stabilize.

2. There’s a shortage of experienced and competent leaders

The demand for professional programmers and software designers is great and growing all around the world. While many people are moving now into software development, the number who have at least a decade of real-world experience is not growing as fast, and many of those who do have not led large-scale development projects. The gap is not being closed by traditional project managers, because most of them do not specialize in software development.

3. We’re still experimenting with management methods

Agile development methods are formally only 12 years old. And there are many competing methodologies out there, none of which has come to dominate the field. While it is good that many different approaches are being tried, a manager who wants to be guided to the “best” method will receive conflicting advice, particularly from vendors who are each flogging their own piece of development-support software.

Shall we advise them to come back in 20 years, when we’re down to one or two leading approaches? Not practical, because the development must go on.

If you’re responsible for software development or the products the software goes in, you’ll have to make some choices based on what’s known now. It’s best to get advice on the methods and the tools, but not to depend on any one vendor to tell you how to proceed.

—————————–

My recent talk at SofTech, 10 Ways to Fail revealed many indicators of failing projects. Download the slides & notes here.

Filed Under: Agile Management, Painless IT Tagged With: agile, bugs, development process, management, product development, project management pathology, quality assurance, software, software maintenance, technical debt

Software Development – not by PERT alone

January 21, 2013

Here are three factors that contribute to the unruliness of software development projects:

1. Estimating the effort and time required to complete a task is difficult. Even when reasonable-looking requirements and specifications of a software package are provided, understanding the difficulty of development may require architecting multiple layers and investigating interactions with a complex environment. Since requirements are generally high-level items, and design has to be done at multiple levels, it is difficult to break down the work into “pebble-sized” tasks and then to keep to a schedule with those tasks.

2. Designing an algorithm often takes experimentation. Engineering a software system requires trying out some things to see if they work, or testing multiple possible ways to implement something to find one with reasonable performance, for example. This aspect of software engineering is so prevalent that Fred Brooks in The Mythical Man-Month advised us to “plan to throw one away.” He meant that at the completion of a complex software implementation (such as an operating system), the designers have learned so much that it is often best to start over and re-implement everything.

3. Assuring that a software implementation functions properly under all conditions may take as long as the design phase. In fact, you may never be able to prove proper functioning, because testing all combinations of conditions is impossible. At best, using test-automation tools and good intuition about where to look for errors, a software team can reduce the number of bugs at the time of a software release, but almost never to zero.

One of the best countermeasures to all of these problems is to use Agiledevelopment methods. Iterative development with regular demonstrations of working software having incrementally greater functionality will help reduce uncertainty and increase the ability of a development team to adapt to a changing world. It also shortens the time between the initial charter of the project and the point where the customer says, “but that’s not what I wanted.”

Even Agile will not save all projects. If you’d like to learn more about why not, download the slides and notes from my webinar, ” Why Agile Won’t Fix All Your Problems.”

And good luck. The world needs software, so we all have to keep on trying to deliver it the best we can.

Filed Under: Agile Management, Painless IT Tagged With: agile, IT development, IT management, IT project failure, project management, project management pathology, software