Communications Suite What If? Doc Question
By Joesciallo-Oracle on Oct 08, 2007
Artwork from Avatar Press
Hypothetical question to the Comms world. What if we were working on a new product and you had a chance to influence the kinds of information you needed to successfully plan for, install, configure, administer, and use said product. Would you be willing to share your thoughts, contribute ideas, and give us feedback on our plans? Again, this is strictly hypothetical.
There are of course, many ways to look at this. For example, you might suggest or rank traditional publication manuals, aka:
- Deployment Planning Guide
- Installation Guide
- Release Notes
- Administration Guide
- Configuration Guide
- Customization Guide
- Online Help
Then again, since we are seriously thinking (hypothetically, 'natch) of potentially doing something very different in the doc space, rather than lock you in to the above traditional mentallity (which is just fine on its own), it would be nice to have thoughts and feedback on the other types of information and delivery sites that we currently provide, such as
- Comms Suite Hub
- Wikis, such as http://msg.wikidoc.info/index.php/Main_Page
- Tech Articles and Notes
- Blogs, like Factotum and Jhawk
as well as comments about Star Trek-like ideas, such as dynamically-generated documentation.
If your interest is piqued, feel free to drop a line or use the Comments section below to brainstorm.
One of my co-workers suggested, and rightly so, that a question such as, "If there's one thing you'd really like to see in the docs, that would really help you do your job better, what would it be?" would also be helpful. Conversely, you might also have the question, "What's been the most frustrating part of the docs?" If you find either of these questions pertinent to this endeavor, feel free to use them.