TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
I'm beginning a new project and would welcome any suggestions for getting
myself prepared. I'm going to be part of the development team for creating a
Windows GUI for our software. (I work in telecommunications, documenting our
hardware and the software that makes it run. Our software right now is
TL1-based; we're going to make a Windows GUI available for customers who
want it.) The development team will include the project engineers, our
product manager, the manager of our field services division, and myself. I'm
excited about doing something totally new, but also feel woefully
unprepared. Documenting a GUI is one thing, helping to create it seems like
I have looked at competitors' materials, which helps when planning my
documentation of the end product but doesn't help me understand the process
involved. I've also learned, from the archives, that there is material on
the Microsoft website that I should review (especially since we will be
creating an MS Windows GUI). Has anyone out there been in my position, and
if so, what resources (books, websites, articles, etc.) did you find that
helped you understand GUIs, GUI requirements, and the GUI development
All suggestions are appreciated. Thanks.
(I don't think this is off-topic, but if any of you feel so, just respond to
me off-list, please.)
Catheryn Mason, Technical Writer
cmason -at- infinitec-com -dot- com
Winner, 1999 IABC Bronze Quill Award of Excellence for Technical Writing