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 have been tasked with writing an internal software style guide. I have a pretty good draft so far with examples, screenshots, links to files where images and code is stored, but I am having a little bit of difficulty coming up with an exhaustive table of UI Elements, their definitions, examples, usages, etc. I am relatively new to software and do not know all of the official terms used to describe common UI elements (things like modal boxes, popup windows, drop-down menus, etc).
Are there any resources available to provide general UI design and style guidelines? I am modeling the UI Element table after the one in the Microsoft Manual of Style (control name, definition, usage, example), but that is written for an audience of tech communicators, not software developers. The audience of this style guide is the internal software development team. The purpose is so that when they create a new piece of software from scratch, they can just plug in the company-wide font, colors, buttons, modals, etc so that all of the applications look cohesive and follow the same UI style.
This email is intended only for the recipient(s). If you are not a recipient, disclosing, copying, or distributing this information is prohibited. The views expressed in this email are not representative of 2Is, Incorporated.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help. Choose your authoring formats and get any output you may need.
Try Doc-To-Help, now with MS SharePoint integration, free for 30-days.
