Documentation: Enough Already! Not.

Mike McCoy Consulting, Other, Problem Solving, Soft Skills Leave a Comment

Documentation. I know we all hate having to create it. I don’t like writing it and feel like I always leave something out. However, our assumptions of what other developers should think we are trying to accomplish by our masterpieces of software are usually filled with potholes (sometimes big ones). The truth of the matter is that no matter how stellar your code or software is – if you’re the only one who understands how it works, it doesn’t do any good.

These are not paintings or sculptures that would live the rest of their days in a museum, untouched by human hands and just collecting dust as they run. In reality, documentation will be added to and changed as the information they describe evolves.

In this blog, we discuss two suggested strategies for the creation of useful and concise software documentation.

Web Development Business

Life as a Software Consultant

John Boardman Business, Consulting, Keyhole, Opinion, Other Leave a Comment

I’ve been in the field of programming professionally since 1990. I started out as a corporate employee for 14 years, then as a consultant, back to an employee, and finally settled with consulting. In both positions, I’ve worked with small, medium, large, and huge Fortune 50 corporations. There are many similarities between being an employee and a consultant, but there are also some significant differences.

In this blog, I’ll explore what life has been like in each role and hopefully give some perspective to others who might just be starting out. Keep in mind when I write “employee,” I am specifically targeting programmers.

Programming With Stenography

Garrett Hopper Other, Technology Snapshot 3 Comments

As developers, we spend a ton of time typing, so any small improvements in speed or comfort are well worth it.

If you’re anything like me, then you spend a full day typing at work only to come home and continue typing into the wee hours of the morning. With so much of my life spent typing, things like RSI are a serious concern. I’ve tried a variety of different ergonomic keyboards and I’ve even switched to Dvorak, but none of it made any significant difference in speed or comfort.

In my search for alternative text input methods, I discovered stenography. In this blog, I will give an introduction to stenography and how programmers (like me) have implemented it in an effort to make typing more comfortable and efficient.

First Experiences With Windows 8

John Boardman Opinion, Other, Problem Solving, Programming 3 Comments

This is a departure from many of the other Keyhole blogs, in that it deals with system software and hardware. However, make sure to keep reading. 🙂 I have built hundreds of PCs over the years. Anybody else remember receiving a RAM upgrade with lots of chips stuck to a foam pad, straightening the pins so they would fit into …

Programmers and the Amazon Have This in Common

Tim Broyles Other, Programming 1 Comment

Have you ever been stuck on a problem, some seemingly un-explainable production malfunction in the code? You’ve stepped though it with the debugger, run enumerable test scenarios trying to simulate what the user is doing, but still the issue remains? Likely so. What can you do? My suggestion: take a walk! Like a silver bullet in the heart of a werewolf (okay, …