Tips for Writing Good Documentation

Technical documentation. I doubt it's something any of us would list as our favorite genre, either to write or to read. But it's one of those necessities we often curse then begrudgingly accept when we have to wade our way through it in order to solve a problem or when we have to write it in order to explain a technical product.
Good documentation is hard to write. There are a number of forms in which technical documents can take: very general or high-level overviews, step-by-step walkthroughs, or auto-generated documents, for example. Add this to the variety of users who might need your documentation - their different needs, technical expertise, learning styles - and you'll probably find there is really no one single format that will work for everyone.

Writing for the Right Audience
With that in mind, the first thing you need to consider when writing documentation for your project is audience. An end-user will want documentation that's primarily instructional - a How-To. While some technical concepts can be mentioned (and explained), the emphasis should be on the interface, not on the back-end. Another programmer looking at the documentation will want additional information: technical details of how program elements work, where in the code actions occur, and if applicable, how to extend the code. Writing for one audience shouldn't preclude writing for the other, but you should consider separate documents - the user's technical documentation and the technician's technical documentation, so to speak.

Types of Documentation

In Jacob Kaplan-Moss guide to writing great documentation, he points to three categories for documentation: tutorials, topical guides, and reference guides.
Tutorials: Tutorials are important as they are often a first impression when someone uses a new tech tool. As we've written about before, there are a number of tools to help you make good tutorials. But if you're writing one, Kaplan-Moss recommends tutorials be quick and easy - but not too easy - and demonstrate how your project "feels." Example: the user guide for the recently release Anthologize blog-to-eBook tool. Note the screenshots that accompany each step.
Topical Guides: These are, in the words, of Kaplan-Moss, "the meat of your documentation." While a tutorial provides an introduction to high-level concepts, topical guides are for those who want to dig deeper. Their main goal should be comprehensiveness. As Kaplan-Moss notes, books often outshine the official documentation, which is unfortunate as the latter can be kept better up-to-date. Example: Django documentation - everything you need to know about Django (and then some).

Reference Guides: Reference guides are designed for those users who understand some of the "how" found in the guides, but are looking for information. "These should be designed for those who already know how to use some API, but need to look up the exact arguments some function takes, or how a particular setting influences behavior, etc. It's important to point out that reference material is not in any way a substitute for good tutorials and guides!" Auto-generated documentation is a start, but without additional writing, editing, organization, it's unlikely to really answer anyone's questions.
And just because it's "technical writing" doesn't mean that you should forgo poetic language, grammar and spell-check. OK, well, at least please edit for spelling and grammar.
Source:http://www.readwriteweb.com/start/2010/08/tips-for-writing-good-document.php

What is Digital Branding?

In order to understand Digital Branding, it is first important to understand the concept of branding thoroughly. Branding involves creating a positive image of a product or service in the mind of the potential consumer. This image could play on a theme; for example, reliability, excellence, customer-friendliness, convenience or even a wide-spread presence. (Remember Hutch? The network that follows you wherever you go?). When a concentrated campaign to drive home the USP (Unique Selling Point) of a company is carried out online, it is called Digital Branding.

Digital Branding Solutions involve creating an aura of the company in cyberspace. This means that whenever a user types a query about a certain product or service, your company shows up every time, that too at the top. Also, the user must really like what he sees and be able to relate to it. This involves a lot of things:

1. A clear grasp of consumer buying patterns, cultural preferences and demographical peculiarities.
2. A good knowledge of the surfing habits of potential clients – what keywords do people use when looking for your kind of product? Do they go to forums, article sites or price comparison sites? (An excellent example: Which sites do people having money to invest surf? Investment sites. Hence, it is a better idea to pitch a piece of land for sale on an investment site rather than a real estate site.)
3. You have to be very familiar with the Internet (Naturally!) and sites where you can make yourself visible.
4. Your concepts of internet marketing and branding must be very clear, so that you know what to deliver, when to deliver it and what medium to use; that’s when branding becomes digital branding.

Good digital branding is an art and a science. It is often best to use the services of a good digital branding and marketing company that can analyze your needs and tailor-make a solution for you. The best part about such services is that they are easily available, extremely effective and give quick results, and also give you a permanent presence on the web.

ConWiz- Complete Content Solutions

ConWiz - Content and Communication Wizards

ConWiz is a leading content solutions provider, specializing in areas as diverse as hardcore Technical Writing, utilizing content for promotion of business objectives using online branding and marketing solutions and also core content management systems.

ConWiz works in areas as diverse as Real Estate, IT, Telecommunications, Automobiles, Nanotechnology, Bioinformatics, Health Care, Banking Insurance, Education, eLearning and Aerospace.

ConWiz and its associated companies run over 150 eLearning programs that reach out to participants from approximately 40 countries worldwide. Do we need a stronger recommendation?

Our solutions encompass a variety of modes such as Animation, Online Branding, Audio-Visual Promotions, Print solutions and Electronic media, to give you the best in whatever's available.