Discussion Locked

Documentation Layout

0 helpful
2 replies
Closed to new repliesThis discussion is closed. It stays readable, but it takes no new replies.
I was assigned to design and come out a company documentation (Eg:- Process Flow, User Guide, Technical Guide and etc). But I do not know how and where to start. It will be greate if you could provide me some suggestion. Thanks

2 replies

by michance

That's a very broad assignment. Much will depend on the nature of your business.

A simple process flowchart can easily be put together with a tool such as Visio. To get the informatin you need, you can interview people involved in the process, or observe them as they work.

User Guides can be paper or electronic. Word and RoboHelp are excellent tools or intermediate efforts. Again, you will be interviewing developers/engineers, and/or working with the products yourself, to get the source information you need for your documents.

As for guidelines, there are many books that help you determine outlines and content for these kinds of documentation.

Further, you might consider getting involved with your local chapter of the Society for Technical Communication (STC). This will make available to you many very experienced people who will be happy to help you as you work through your assignment.

I hope this helps. Best of luck to you.

This discussion is closed to new replies.