Election Day and Democracy

On November 4, 2008, the U.S.A. is holding elections for the next U.S. President as well as many other political offices and issues. As a writer, the thing I value most in my life is freedom of expression, because without this, I cannot write freely. Whether one is a technical writer, blogger, fiction writer, or [...]

Five Tips When Creating a Glossary

When creating online help systems, it is important to include a glossary as well as the traditional table of contents and search sections. Why a glossary? Because sometimes people get tired of surfing the help explanation for something, and go right to the explicit definition of a term to find out what it means. It [...]

Thank you Dimitri for Doxygen

Currently, I am working in a software development environment that utilizes Microsoft Visual C# as the central programming language, and as the person in charge of documentation, I had to research the Internet to find the best possible source-code documentation generator that was out there. After two months of research, I felt that the Doxygen [...]

CHEETAH: Cash-Flow Management Metaphor for Writers

When I lived in Brazil (1991-1996), I lived in a country that suffered from hyperinflation. This means that the currency is constantly depreciating in value. So, one day it took 1000 Brazilian “cruzeiros” to buy one U.S. dollar, and then one week after that, it took 2000 Brazilian “cruzeiros” to buy one U.S. dollar. So, [...]

Reader Challenge

Dear Reader:
Today I offer you a challenge. Yes, a true challenge!
Here is the question you must consider:
What assumption must you, as a writer, NEVER make as your compose your article, paper or blog?
Please answer this question by using the Contact Form of this blog.
If you get the answer correct, I will send you a [...]

My Five Faves

Technical Writers usually count around five applications as their “faves”, or favorites. These applications all play a unique role in the creation of documentation and write-ups of all kinds. Here are my faves, and why I love each one of them:
One. Microsoft Word 2007. Some people have had a tough time adjusting to the new [...]

Survival Tips for Writers: Riding Out The Storm

Unless you have transformed yourself into a proverbial dodo bird that likes to place his or her head under the sand, you have seen the headlines on the Internet, television and radio about the worldwide economy and how the markets are tumbling down. This will affect writers too – no doubt. When I lived in [...]

Five Great Blogging Tips

Blogging is both fun and hard work. It requires diligence, perseverance, patience, steadfastness, and also inspiration. There are some days where you will have more ideas than you can handle, and you will have other days where you can’t fathom a single original idea. Such is the life of the blogger. So, don’t get discouraged [...]

Greater Website Visibility: Ten Suggestions

The #1 communications avenue today is the Internet. This is indeed a profound conclusion to draw, but it is true. No longer do you see businesses focusing mostly on television and radio. Rather, the focus now is evenly distributed between former traditional methods of advertising along with the Internet. On a daily basis, the Internet [...]

Ten Majors I recommend to become a Technical Writer

If I had to go through college again, these are the ten majors I would select from – en route to a career as a Technical Writer. As I list each major, I will tell you exactly why I have recommended it. You will notice quite a diverse selection, but, truly, each one contains great [...]