Questions

Writing a ****?k is not ***? difficult or daunting ***? it sounds and can easily be turned into a very profitable home business.  Writing doesn’t require a lot of expensive equipment or a huge financial investment.  In ***?ct the only tools you will really need are a computer, a word processor and a ****?d amount of uninterrupted dedicated ***?me.  I’m guessing the latter is probably the most difficult thing for most of us to come by ****? there are some ideas it might help to remember.

Writing a ****?k doesn’t all have to be done at one ***?me or in one sitting, so don’t be discouraged by the idea that you might only have a few minutes to dedicate to your ****?k every day.  No matter what your topic may be, making a clear outline for your ****?k can be roughed out with only a few minutes of brainstorming.  Once you learn how to put your workflow in order writing about any subject becomes a breeze.  And finally, YOUR ****?K DOES NOT HAVE TO BE 300 PAGES LONG to be a bestseller or very profitable for you!

When it comes to writing there’s really nothing to it ****? to do it.  It’s the process of publishing that can be your biggest stumbling block.  These days when it comes to publishing you have three major options.

1.)    Traditional Publishing.  Traditional publishing means once you finish writing your manuscript you submit it to a publishing house through a third party called a “literary agent”.  Most traditional publishing companies ****?h ***? Random House or Simon & Schuster will NOT accept or read manuscripts submitted directly by authors ****? instead rely on literary agents to read and pitch them the gist of your ****?k.  

On top of that, not every literary agent will review every type of ****?ks or story so if you intend to go the traditional route you will have to shop for and ***?tition an agent to represent your work.

2.)    Independent Publishing.  Also known ***? “self-publishing” means that you can get your manuscript published by a ***?lf-publishing house like Xlibris or iUniverse without the need to find an agent to read and promote your work.  It’s a lot easier for beginners to take this route ***? there are ***?r fewer frustrating obstacles and there is a substantially ***?ster turnaround ***?me to ***?e your finished ****?k in print.

However there are some important differences to consider between traditional and independent publishing.  In general it probably won’t cost you anything up front to find an agent and get your ****?k published traditionally other than ***?me.  Most legitimate agents WON’T charge to read your manuscript or submit it to publishers, ****? the down side is that the publisher and the agent generally get to keep about 90% of the profit from your sales.

On the other hand IT WILL COST YOU upfront to have your ****?k published independently.  The bright side is there is no lengthy approval process, you get to keep more of your own profits and you can usually ***?e your work in print within about 3 months from the ***?me you submit your manuscript.  

3.)    Online Publishing.  Your third option for publishing is convert your manuscript to PDF format once you finish writing it on your computer and upload it to online ****?kstores like Lulu.com.  You can do this in combination with your printed ****?k IF you choose to go with an independent publisher like Xlibris, ****? you will likely be on a contract that prohibits you from ***?lling your ****?k elsewhere if you decided to go with a traditional publisher.

Once you have your ****?k uploaded to a website like Lulu it will be available for sale immediately at whatever *****?e you decide to charge for it.  With online publishing your ****?k could literally be for sale and earning you money within MINUTES of the ***?me you finish writing it without any hassle, approval process OR ***?tup fees.      

After you finish writing and publishing your ****?k the only thing left to do is market it.    If you found this information helpful and are really ***?rious about writing and publishing and would like to learn more please come visit my website: www.showme-tellme.com.   I have prepared a complete easy to follow step-by-step guide that will take you by the hand and show you EXACTLY how to go about writing, publishing AND marketing your very own ****?k.  I will show you everything you need to know from the ***?me you start writing until the day you collect your first royalty check.  Just think of how ****?d it will feel when you can introduce yourself ***? an author.


- rljackson5

OVERVIEW

You, a non-writer, have just been assigned to write the documentation for a product your company produces or markets. You may be stressed out about the assignment. Fear not! This article will get you started on the path to writing a successful document.

QUESTIONS AND NOTES

As soon as you get assigned to the documentation project you must begin to take notes and ask questions. The major goal of this early information gathering is to gain access to the sources of information that you will need in order to write your document. Thus these early notes should be related to where you will get your information: things to read and people to contact, and a product to play with.

TIP: There is always something to do or learn on a Documentation project. Don’t stop working while you are waiting for something else to happen.

LEARN PROPER USE OF YOUR WRITING TOOLS

Do NOT get immersed in new technology. For most companies and for most documentation projects, investing the money and time to learn a Content Management System or exquisite document writing software are not worth the effort. Documentation writing is often the tail end of a project, and you will have no time to learn new technologies. Instead learn to get the best from your existing word-processing tools.

* Learn about and understand why you should use your word processor’s “styles” for formatting your document. “Styles” (or whatever your word processor calls them) are sets of characteristics such as a structure and formatting. For example, Heading (level) 1 is a style, Heading 2 is another style, and so are Title, Body Text and others. When you apply a style to a block of text, two things happen: (1) the formatting of the style gets applied to the text and (2) the word processor will be able to understand the structure of the document. The word processor’s tools will use the headings to automatically generate a table of contents.

* Learn to use your word processor’s outlining capability. The outliner automatically assigns styles to the headings in your document. Design your User Document using your word processor’s outlining capability.

* Learn how to use your word processor’s revision system. The revision system is a facility where the author writes a document and then sends it to a reviewer. The reviewer can make revisions to the document, and sends it back to the author. The author can then choose to either accept or reject each revision provided by the reviewer. You will have to be able to deal with revisions from multiple reviewers for each part of the Document.

Most word processor Users do not know how to use the revision system that their software provides. You might wish to create a document about the revision system for your reviewers. Remember to tell them what the revision system is about, as well as how to use it.

Technology comes second. Our goal will be to produce a great document, providing the:

* content (the information that your Reader needs or wants) and

* effective access to that content

(giving your reader the ability to find what is needed).

DOCUMENT ALL PEOPLE ON THE PROJECT

Pretend that it is 10 years from now. You or someone else must re-write the User Documentation for the product you are now working on. You or someone else must be able to contact those who worked on the original project or the people who replaced them. You may need to ask them questions, or at least to find the notes and other background material related to the document that they produced. You must keep a record of everyone who worked on the project (for the product itself and for the User Documentation.)

The people who are working on the project include (there may be others, include them in the list):

* Project Manager

* Those who will approve the parts of the Document, and who will approve the final Document

* Project Team

* Contacts

* Marketing

* Sources of Information

* Publisher of Document

* Editor

* Indexer

You should keep (for yourself and the entire project team) the following information. It should have an entry for every person inside and outside the organization who is affiliated with the project, and these data:

* Full Name

* Role in the Product Development

* Organization and Position in the Organization

* E-mail address

* Telephone contact (FAX number)

* Office address (if there is a company-wide directory, get the address from there, when you need it)

* Their expertise and what they did on the project

* Any other relevant information

DO IT NOW: LIST THE PLAYERS

Create this list of everyone related to the project. You can keep the list using a word processor, spreadsheet, or dedicated address-book software and in your e-mail program. Use whatever method you are used to using (a computer program is best, as it permits you to edit the list, and to share it with the other members of your project team).

Include the information I suggested above about each participant. The goal is to know who worked on the project, their role in the project, and how to contact them.

Keep the list up to date.

YOUR PATRON

Let’s call the person that assigns you the task of writing the document (or a portion of it) your “Patron”. This is the person who is responsible for ensuring that the documentation gets produced. There are several things you must ask of your Patron, and you must carefully note the responses.

Ultimately, your Patron must provide you with (or put you in contact with someone who can provide you with):

* Access to literature about the product

Includes marketing, design, concept information, documentation for similar products; in short, anything they will let you read that might be related to the product. Once you get the written documentation, read as much as you possibly can about the product. A goal is to become the expert about the product.

* Access to the members of the project team.

Not only the names and contact information, but also provide the “clout” to get these people to provide information to you. This is vitally important!

This access must include the marketing and design teams. They can tell you about the potential Users of the product.

* Access to the product itself or a mockup of the product.

So you can gain some hands-on experience with the product.

Access to Users of similar products; access to potential Users of this product (or information about them)

If you have been hired by, for example, the Human Resources Department of the company, then Human Resources will have to direct you to the person on the project who is your Patron. Your Patron is not your client.

In the business world we speak of our “client.” That is usually the person or organization that hires and pays us. It’s the one we are working for.

However in reality your client is your Reader. It is your responsibility to do the best job for your Reader. If it’s necessary to go against the judgment of your Patron then you must be prepared to convince your Patron of the merits of your way of doing the work.

Read all the material you can get about the product and the project . It will prepare you for the interactions you will have later with the project members. Be prepared by knowing as much background information as you can before you have your first information gathering session (meeting).

Ask: “What can I read or do in order to get the background on this topic?”

Even if you are the developer, there are things you need to learn. One of the most important is concerns the characteristics your potential User.

Your early investigations should be aimed at answering these questions:

1. Overall (brief) Description of the Product.

What does the product do for the User;

How does the product change the way the User currently does things.

2. Intended Audience (the Users) for the Document and the Product

This is the “target market” for the product; information about who will use the product. This information could come from the marketing and design groups for the product. Ask them: “Tell me about your potential User of this product?”

3. Goals of the Document that You are Writing

This is the “scope” of the document…what is your document supposed to deal with regarding the product. See the next item on this list, item 4. Is your document to be a User Manual, Reference Manual, Setup Guide, or a combination of these?

4. Are there to be any other User Documents to be produced that are related to this product? That is, is the document you are working on a portion of the User Document set that the organization will produce for the product? If yes, what are the other documents in the set (so you can refer to them in your document)?

5. The contact information that I discussed just above. For every question you might have, you must have a source (be that source written or verbal) for an answer.

The items on the above list would probably be answered by “higher level” members of the project team. Perhaps your Patron can answer them; if not, he/she must guide you to where (or from whom) you can get the answers. These are the first things you will write about in your User Documentation. Get this information early in the project.

In short, you need to get both written documentation about the product and contacts who you can ask to provide more information.

Eventually you will enter this information in a word processing document that you can share.

Document all of this information.

ASK ABOUT MECHANICS

Very early in the documentation project you should ask your initial contact about these writing-mechanics topics:

* What is the time frame for producing the documentation. When do you have to have the writing finished so that it can be edited and published.

* What are the Company’s (your company, group, division) Documentation Guidelines and Standards

Look over some acceptable documentation produced by the Company

* What are the Legal Guidelines for the documentation

You will need this for disclaimers, safety information, and the copyright notice

* How the document and components of it are to be approved by those responsible for the product and its documentation.

Ensure that you know when and how the components or stages of the document are to be approved. Know who is to approve your writing. Stay in close contact with those people.

* What writing and outlining software does the Company use

Your software should be compatible with that of the Company

* Get a Style Manual

A style manual is a guide for selecting phrases. It sets down writing customs for your industry or Company. For example, the style guide for the indexing community says that the plural of “index” is “indexes,” not “indices.” A mathematical style manual would select “indices” as the plural of “index.”

If your company has adopted a style manual, use that one, if appropriate to the product. If not, search an on-line bookstore for “Style Manual” or “Style Guide” and your industry, such as “Style Manual Mathematics”.

* What are you to deliver on this project?

* How will the document be published

Printed, on-line, Adobe Acrobat PDF, context-sensitive help, XML (so it can easily be manifested in any display medium)

Keep track of all this information. You will organize it and add to it as you this documentation project moves forward.

GIVE SOME INFORMATION

You should give everyone your contact information so they can get in touch with you. You might consider using your business card, and writing on it that you are writing the User Document for whatever product. Make it easy for your contacts to get in touch with you. Ensure that you have your contact information in any e-mails or copies of the document that you send to others.

You should also tell your Patron how you plan to write the documentation. You will be writing the document in pieces (which are logical topics or modules), and provide the pieces to members of the product team for review.

Also (unless you are a professional writer, in which case you may do most of the editing yourself) make it known that you plan to use someone else to edit your document. Interim materials that you provide might not be edited; you are providing them in order for reviewers (”experts” within the project team or marketing) to evaluate them on completeness and accuracy. You will ensure clarity of the writing in the (later) cycles of editing and revision.

One of my (ideal) goals for you is that you become the focus of all the User-oriented information about the product. You become the resource that others on the project turn to for information.

I believe that you should provide information to those involved (and especially those to be involved at a later stage in the project, such as the indexer) as early as possible in the life of the project. There are several benefits to this:

* They will learn about and think about the product and project. This will happen because people do want to do a good job… after all, it’s their livelihood.

* There will be fewer surprises. People know what is happening with the project, how their roles and timing might change. Encourage your Readers to comment back to you about anything related to your work.

Learn, learn, learn! Become the expert about the product and its documentation.

SET UP AN INFORMATION SHARING RESOURCE

I believe in sharing information…it makes for a better work environment and a better product. Use whatever available technology you have to create (or get created) some kind of resource to share information. This information will be in the form of computer files…nothing magic.

You may be able to use a shared directory on a local network, or a protected area on your company’s intranet. Investigate what is needed. Provide read and write access to all the people (inside the company) who are involved on the project.

One of the first things to post is the list of people on the project. Make sure that whatever you post, it is in a form that everyone who has access to it can read (and possibly write) it.

NEXT STEPS

Other articles in this “New Technical Writer” series will assist you as you progress through the writing project. Look for them in the links in the “Resources” section.


- Barry Millman

One that includes tools for organizing characters, events, etc
Right at this moment, I dont give two hoots what the publishing companies want or what other writers do. I wasn’t asking for advice on how I should write. I just asked for the best program that combines word processor, character list, events list etc all in one program. If you don’t know of any, kindly move along and answer a question you DO know the answer to.
- Inspire

If you have been constantly writing for the last few days or weeks, you may suddenly start feeling like your ideas have completely dried up! It happens to all of us writers at some time or the other. This nasty syndrome is commonly referred to as the Writers Block!

The writers block can get the best writers inactive and anxious for long periods of time. It is like the brain just locks up and refuses to cooperate with you. If you are a writer, you know that nothing can get scarier than that!

So how does one go about cracking this non-cooperation code the brain generates? What is the way to debug the Central Processing Unit of the brain? This being such a common problem, we researched it a bit and thought of giving you some nice trip to work around this common yet nuisance of an issue!





If you have been feeling over burdened with the writing, just take it easy and do something different. Cook up a nice dish, go for a movie, treat yourself to some retail therapy, do whatever it takes to get your mind off the tension.





Come back home, sit in front of your PC and type something into your word processor. Never mind what you are writing about – just keep at it and do not edit your work.





Then take a deep breath and go through the article. Pick up the nice portions and keep these particular paragraphs in mind.





Use the same style of writing in your next article and watch your style of writing now. It would have been far improved than ever!





With this, your creative juices will get free rein and you will do much better from now on.





Always use the same technique when this mental block strikes again. This works wonders each and every time!





Remember to take a nice break every once in a while. Get up from your chair and move around every one and half hours or so. Stretch a little, so that you can get rid of the stiffness. Even the slightest discomfort could end up distracting you.





Only a relaxed mind can function properly. So never cause physical or mental strain to yourself. Writing takes a lot of mental energy, so see to it that you are fresh enough when you start a new days work.





It helps immensely to plan out how much you want to work each day. Set a deadline for yourself and see that you fulfill it each day. This keeps you motivated and doing your best always!





Keep writing as many articles as possible. This will help hone your writing talents and also make you more confident about your own capabilities. The more you write, the better you will get at your job! 





Writers Block is really no big deal. Though it may appear an insurmountable problem at first, it really can be sorted out quite easily. Make a note of the above points and keep applying the said techniques each time you feel yourself getting pulled down by your work.

  


- Aspasia