The following general resources are Web sites of interest to Help authors, technical communicators, and programmers.
| Help |
| General Help Resources |
|
Helpware Group
www.helpware.net
Provides comprehensive support for MS Help Viewer, Win Help, MS HTML Help, MS Help Support (VS Help), and MS AP Help.
|
HATT Forum
www.egroups.com/group/HATT
Discussion group focused on technical writing.
|
indoition: Software User Assistance
http://www.indoition.com/index.html
Offers links, articles, checklists, and tools for writing support documentation. |
I'd Rather Be Writing
http://idratherbewriting.com/
Blog by Tom Johnson on technical writing. |
MacOS Help
developer.apple.com/macos/help.html
Resource for developing Mac OS X and IPhone OS applications.
|
RoboHelp 8
http://www.grainge.org/pages/authoring/
rh8/rh8.htm
RoboHelp guide, 'try it' exercises, and other articles by Peter Grainge.
|
|
Usable Help
www.g2meyer.com/usablehelp/index.html
An examination of support documentation and Help systems for software and consumer products by Gordon Meyer.
|
OmniHelp tripane on-line help viewer
https://sourceforge.net/projects/omnihelp/
Developer support for OmniHelp, a cross-platform, browser-independent, help system that uses JavaScript and CSS with HTML 4.
|
"What is the best output format for me?," The RoboColum(n)
http://notcolin.wordpress.com/category/technical-writing/
Summary of various Help output formats
|
Adobe RoboHelp Help and Support
http://www.adobe.com/support/robohelp/
|
Author-it Knowledge Center
http://kc.author-it.com/#b45748t24310n12828
|
Flare Tips & Tricks
http://www.clickstart.net/presentations/
flaretips_writersua10.pdf
|
Madcap Flare Support
http://www.madcapsoftware.com/support/
|
The Writer's Rough Guide to Everything Flare
http://kungfuwit.wordpress.com/
|
Tech Writer Today - TechWhirl
http://techwhirl.com
Online magazine with technical writing and technical communications articles.
|
|
| Microsoft Help |
WritersUA Microsoft Help
www.writersua.com/articles/
news/news_2007_1201.htm
Articles and links focused on Microsoft Help Technologies including WinHelp, HTML Help, Help 2, Assistance Platform, CE Help, and Sandcastle.
|
Help-Info.de
http://www.help-info.de/en/welcome.htm
German-based resource for Microsoft Help technologies including Help 3, Windows Vista AP Help, Help 2, etc. |
The Help Guy
http://blogs.msdn.com/b/thehelpguy/
Paul O'Rear's blog for all things Help technology related. |
Microsoft HTML Help 1.4 SDK
http://msdn.microsoft.com/en-us/library/ms670169.aspx
Microsoft documentation and links to download for HTML Help.
|
MSHelpWiki.com
http://www.mshelpwiki.com/wiki/tiki-index.php?page=MsHelp
Created by Microsoft Help MVPs and maintained by the Help authoring community.
|
| Java Help - Sun Microsystems |
|
JavaHelp
https://javahelp.dev.java.net/ Introduction and support to Java's online help system. |
|
| Oracle Help - Oracle |
Oracle Help for Java
otn.oracle.com/tech/java/help/content.html Oracle support for Java-based help systems. |
|
| DITA |
DITA Overview
http://www.writersua.com/DITA_overview.htm DITA introduction, which includes a business case, references, and a 5-minute Flash tutorial. |
DITA Web Resources
http://www.writersua.com/DITA_webresources.htmCollection of resources including communities, mailing lists, and publications. |
DITA Tools A-Z
http://www.writersua.com/DITA_tools.htm Collection of DITA tools. |
DITA Tutorials
http://www.writersua.com/DITA_tutorials.htm |
DITA History
http://www.writersua.com/DITA_history.htm |
OASIS DITA TC
http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita Non-profit consortium committed to developing and promoting open web standards. |
|
 |
| World Wide Web Technologies |
| General Technology Sites |
World Wide Web Consortium (W3C)
www.w3.org Provides guidelines and support for website development. |
Webmonkey
www.webmonkey.com Resource for developing websites. Includes links, articles, tutorials, cheat sheets, and color charts. |
|
A List Apart
www.alistapart.com
Non-commercial weekly magazine for web designers, developers, and content producers. |
Association of Internet Professionals
www.association.org Organization that provides webmaster certification training. |
|
W3 Schools.com
www.w3schools.com
Resource for free web building tutorials, from basic HTML and XHTML tutorials to advanced XML,XSL, and WAP tutorials.
|
Joel Sklar web site
www.joelsklar.com/access.htm
Collection of web accessibility resources, tools, and demos.
Accessibility resources, tools, and demos |
"No Fuss Accessibility," Antonio DaSilva, WritersUA
www.writersua.com/articles/accessibility/index.html
Describes how you can quickly and easily create documents with enhanced accessibility options for vision-impaired users using Microsoft Word and Adobe Acrobat. |
Web Devout
www.webdevout.net/
Collection of Web development tools, articles, and support. |
Web Designer Wall
www.webdesignerwall.com/tutorials/
Collection of web development tutorials (e.g. CSS3 Rounded Image with jQuery) |
| Cascading Style Sheets (CSS) |
Cascading Style Sheet Reference Guide
homepages.cwi.nl/~steven/www/css1-qr.html
CSS cheat sheet by Steven Pemberton. |
CSS-discuss.org
www.css-discuss.org/
Mailing list focused on CSS technology. |
| Markup Languages |
"The Ultimate Roundup of Indispensable and Helpful HTML5 Tutorials," Siva Kumar
www.1stwebdesigner.com/resources/the-ultimate-roundup-of-indispensable-and-helpful-html5-tutorials/
Collection of HTML5 tutorials including HTML5 for beginners, HTML5 techniques, and HTML5 cheatsheets. |
FAQ - WHATWG Wiki
wiki.whatwg.org/wiki/FAQ#What_is_the_WHATWG.3F
Wiki dedicated to HTML5 technology. |
IBM.com
www.ibm.com/developerworks/library/x-html5
Articles by IBM focusing on HTML5 development. |
W3C - HTML5
www.w3.org/html/wg/html5/
|
Web Developer's Virtual Library
wdvl.internet.com/Authoring/Languages/XML/XHTML/
Introduction to XHTML with examples. |
Dynamic HTML Lab
www.webreference.com/dhtml/
Introduction to DHTML by Peter Belesis. |
XML - IBM.com
www.ibm.com/developerworks/xml/
Collection of XML articles and tutorials by IBM. |
O'Reilly XML
www.xml.com/
Introduction to XML by O'Reilly. |
| Scripting Languages |
JavaScript.com
www.javascript.com/
Collection of articles focused on JavaScript support. |
WebDeveloper's Journal - JavaScript
www.webdevelopersjournal.com/
JavaScriptWeenie.html
Collection of JavaScript articles and tutorials. |
MSDN - Windows
msdn.microsoft.com/library/ms950396.aspx
Microsoft introduction to Windows scripting technologies. |
PHP Hyptertext Preprocessor
www.php.net/
Introduction to PHP with tutorials. |
PHP Builder
www.phpbuilder.com/
Collection of PHP articles. |
|
| Tools |
|
TechComm Toolbox
http://techcommtoolbox.com
Tools for technical writers. |
| Adobe |
|
Adobe in Technical Communication and eLearning
Videos with tutorials regarding Technical Communication Suite products.
|
FrameUsers.com
www.frameusers.com
Adobe FrameMaker reference site.
|
|
PatternStream
www.patternstream.com
Provides an expensive but solid option to import databases into FrameMaker.
|
FrameMaker Developer Center
www.adobe.com/devnet/framemaker
Collection of Adobe FrameMaker video tutorials. |
|
FrameScript
www.framescript.com
Introduction and sample scripts by Finite Matters Ltd. (FML)
|
FrameScript Tutorials
http://www.frameexpert.com/
tutorials/index.htm
|
|
Adobe.com Tutorials
http://www.adobe.com/support/tutorials/
A list of tutorials organized by product.
|
| PDF |
|
PDFzone.com
pdfzone.com
All things PDF: tools, PDF connections, how-to, developers corner, services.
|
PlanetPDF.com
PlanetPDF.com
A comprehensive, popular, and independent web site exclusively focused on Adobe Acrobat/PDF users and uses, which offers many free tools and plug-ins for Acrobat.
|
|
PrintToPDF
www.jwwalker.com/pages/pdf.html
Inexpensive tool for the Macintosh that creates PDFs from within many applications without needing the full Adobe Acrobat package.
|
|
| Content |
| Editing |
|
The Editorial Eye
www.eeicom.com/eye
|
The Technical Editors' Eyrie
www.jeanweber.com
Provides resources covering the wide range of knowledge and skills that technical writers and editors need when editing manuals, online Help, web sites, and other materials. This site demonstrates that technical editing goes far beyond copyediting and proofreading. |
| Error Messages |
|
"Error Messages: More Important to Your Web Site Than You Think," Grace Stoeckel, MarketingProfs.com:
www.marketingprofs.com/3/stoeckle1.asp, Subscription required
|
"Issue #10: The Web Shouldn't Be a Comedy of Errors," Scott Berkun, UI Web.com:
www.uiweb.com/issues/issue10.htm
|
|
"Error Message Guidelines," Jakob Nielsen, Useit.com:
www.useit.com/alertbox/20010624.html
|
"Designing and Writing to Reduce User Errors," Michael Albers, WritersUA.com:
www.winwriters.com/
articles/errors/index.html
|
|
"Non-Fatal Errors: Creating Usable, Effective Error Messages," Emily Wilska, WritersUA.com:
www.winwriters.com/articles/
message/index.html
|
|
| Localization and Translation |
|
American Translators Association
www.atanet.org
|
MultilingualWebmaster.com
www.multilingualwebmaster.com
MultilingualWebmaster.com was created to provide an open forum for developers and managers of multilingual web sites. Our goal is to share information and innovation and to promote "best practices" in multilingual web site design.
|
| Single Sourcing/Content Management |
|
Association for Information and Image Management International
www.aiim.org
|
@Brint.com
www.brint.com
|
|
The Delphi Group
www.delphigroup.com
|
Documentum
www.documentum.com
|
|
FileNET
www.filenet.com
|
International Digital Enterprise Alliance
www.idealliance.org/
|
|
Hyperknowledge
www.hyperknowledge.com
|
KMWorld
www.kmworld.com
|
|
Verity
www.verity.com
|
|
|
| Information Design |
| General Design Resources |
|
Saul Carliner's website
saulcarliner.home.att.net/id/
Processes, techniques, and models of information design focusing on designing and dveloping content including worksheets for preparing an information plan, instructions for setting objectives and planning an evaluation, guidelines for choosing a "type" of communication product and media, and issues to consider when setting editorial guidelines.
saulcarliner.home.att.net/idbusiness
Various resources on the business and management of information design groups including worksheets for setting budgets and schedules, tips on starting a successful work team, and an overview of the production and maintenance phases.
|
EPSS InfoSite
www.pcd-innovations.com
|
Human Factors International
www.humanfactors.com
Human Factors International offers user-centered design consulting, training, and products
|
Idea Watch
www.ideawatch.org
Web site that focuses on Information Design gurus, books, ideas, and best practices. Offers advice about how to improve the user experience. Encourages technical communicators/information designers to be more intellectual and think more critically.
|
Intranet Resources
www.intrack.com/intranet
|
Morkes, J. and Nielsen, J. (1997). "Concise, SCANNABLE, and objective: how to write for the Web."
www.useit.com/papers/
webwriting/writing.html
|
"Eye movement tracking research." Stanford Poynter Project.
www.poynter.org/eyetrack2000/
|
|
| Accessibility |
Microsoft Windows Guidelines for Accessible Software
Design
msdn.microsoft.com/library/default.asp?
url=/nhp/Default.asp?contentid=28000544 |
Section 508 Website
www.section508.gov |
WAI Website
www.w3.org/WAI
The Web Accessibility Initative homepage features the latest information
on making your website accessible for everyone. |
Screen Reader Simulation
www.webaim.org/simulations/screenreader
This website provides examples of what it is like for visual impaired users to access the web using a program called a screen reader. |
Low Vision Simulation
www.webaim.org/simulations/lowvision.php
This website simulaties what it is like to view a webpage as someone with a visual imparement might see it.
|
The Bobby Validation Tool
www.cast.org/bobby
A free service that will check your website and expose any accessibility issues. |
Remove colors, CSS, and check ALT tags
www.508compliant.com/tools.htm
A set of demo tools that check the ease of use of your website. |
"Delivering Inclusive Websites"
http://coi.gov.uk/guidance.php?page=130
Standards and guidance on producing public sector websites from the Central Office of Information. |
| Programming Languages |
| Java |
|
Sun Microsystems
java.sun.com
Home page for JavaSoft, the subsidiary of Sun Microsystems that is developing Java. It contains many links to other sources of information about Java. |
Gamelan and Jars
www.gamelan.com
www.jars.com
Great sources for Java information and products, especially for developers.
|
|
Netscape
developer.netscape.com/tech/java
Netscape's Java Developer Central
|
1st Java Navigator 5.0: Auscomp
www.auscomp.com
Adds Java tab and tree navigation control to Web pages. Features include unlimited tabs; choice of tab location (top or bottom); customizable fonts, colors, and images.
|
|
HelpIndex: PHD Computer Consultants Ltd.
www.phdcc.com
An applet for navigating through collections of HTML documents, with contents tree, server-independent keyword indexing, and index table selection. Version 2.1.0.
|
IMINT.COM
www.imint.com
Applet menus and Java information management systems for websites and intranets are our sole speciality. 30 products across 6 ranges serve every need and every pocket.
|
|
HTMLSearch:MandoSoft
www.bigfoot.com/~mandosoft
Lite (free) and Pro (shareware) versions. Both allow you to search HTML pages that are stored on a CD, LAN, etc., or on a Web server.
|
Hi Spy:PHD Computer Consultants Ltd
www.phdcc.com/hispy
Full-text search applet for CD-ROMs.
|
|
Home Page Search: Babbage
www.babbage.demon.co.uk
Free, client-side search applet for HTML documents.
|
Quest Agent
www.jobjects.com/products/questagent
Enables fast document searching from any Java-compatible browser without a server. Current version uses SWISH index files to find documents. Quest Agent is especially suitable for publishing HTML documents on a CD-ROM or a floppy disk. (SWISH is a popular software for indexing collections of Web pages or other text files, and it's free: sunsite.berkeley.edu/SWISH-E.)
|
|
| Professional Organizations |
|
ACM
www.acm.org/sigs
sigchi.org/listserv
Special Interest Group on Computer-Human Interaction
|
LISTSERV@ACM.ORG
ACM mailing list that carries both academic and commercial announcements of events, web sites, products, and services of direct interest to the CHI community. The list is a moderated, announcements-only list called CHI-RESOURCES. Subscribe by sending "subscribe chi-resources YOUR_NAME-HERE" as the body of a message to
LISTSERV@ACM.ORG.
|
|
Fullfont.com
www.fullfont.com
Informative resources for technical communicators and computer information systems professionals.
|
HTML Writers Guild
www.hwg.org
The world's largest international organization of Web authors with over 110,000 members in more than 150 nations worldwide.
|
|
Society for Technical Communication
www.stc.org
|
Tech Pubs - Resources for Technical Writers
www.techpubs.com/resources.html
|
|
TC Library
tc.eserver.org
|
TECHWR-L Forum
http://techwhirl.com/email-discussion-groups/
|
|
Australian Society for Technical Communication
Victoria: www.astcvic.org.au
New South Wales: www.astcnsw.org.au
|
Technical Communicators Assoc. of New Zealand
www.tcanz.org.nz
|
|
TECHWR-L Mailing List Archive
http://techwr-l.com/archives/
|
KeyContent.org
www.keycontent.org/
tiki-custom_home.php
|
|
Association of Information Technology Professionals
www.aitp.org
|
|
| Usability |
|
Jakob Nielsen's Usable Information Technology
www.useit.com
|
Article - Secondary Windows in Online Help - What Do Users Really Make of Them?
www.stcsig.org/usability/newsletter/
0101-secondary-windows.html
|
|
Article - Toward Usable Browser Hierarchies for the Web
www.microsoft.com/usability/
UEPostings/HCI-kirstenrisden.doc
|
Usability.gov
www.usability.gov
Resource for designing usable, useful, and accessible web sites and user interfaces.
|
|
Usability Professionals' Association
www.upsassoc.org
|
Usability References
www.usability.com/umi_links.htm
|
|
User Interface Engineering
www.uie.com
|
WebWord Usability Consulting
www.webword.com
|
|
| Wireless |
iPhone Dev Center
developer.apple.com/iphone/index.action
Developer support for iPhone and iPad applications. |
iPhone Dev Forums
www.iphonedevforums.com/forum/
Find answers to your developer questions on iPhone Dev Forums. |
Android Developers
developer.android.com/sdk/index.html
Developer support for Android applications. |
Microsoft Visual Studio 2010 Express for Windows Phone
www.microsoft.com/express/phone/
Developer support for Windows Phone 7 tools. |
Blackberry Developer Zone
na.blackberry.com/eng/developers/
Developer support for Blackberry applications. |
