Download PDF

Work experience

Technical Writer

Digital Equipment Corporation

Was the project leader for PDP-8 and DBMS-10/20 documentation. (Project leader meant having full technical responsibility for a documentation set.)

Projects

TRS Users Guide, TECO-8 Reference Manual, FORTRAN-8 Reference Guide, RTS-8 System Generation Guide, RTS-8 Users Guide, DBMS-10/20 Utilities Guide, DMS-10/20 DDL Guide, DBMS-10-20 Users Guide.

Contractor

Digital Equipment Corporation
  • Designed and created a document describing a forms-based lead (potential sales) tracking system used by Digital’s sales organization.
  • Designed and implemented the help system that accompanied the product. Created a document describing a sales price forecasting system.

Contractor

Aurora Technologies

Designed and wrote hardware and software manuals describing add-on boards for SPARC workstations.  (4 contracts)

Projects

SBox Installation Guides, FirstScan Guide

Jun 1999Oct 2008

Senior Principal Writer for Documentation and Web Services

TotalView Technologies

TotalView products are used by developers debugging programs in C++, C, and Fortran. These programs run on multi-core systems, clusters, and supercomputers.

  • Wrote web pages and integrated them into a both source control and  CMS systems.
  • Created web pages that use Perl, PHP, and JavaScript. JavaScript programs modified the DOM and CSS styles.
  • Wrote code that integrated  information collected by web forms into MySQL databases and with salesforce.com.
  • Created all documentation and wrote most of the copy for the company’s web site.
  • Programmed customized converters to change FrameMaker documentation into HTML and help.
  • Presented webinars to customers and prospects.
  • Created and wrote for a tip-of-the-week mailing list that emphasized either product features or debugging techniques.

Projects         

Help for all products, Installation Guides, User Guides, Reference Guides, Memory Debugging Guides, New Features Guide, Creating Type Transformation Guide, Platforms Guides, Reference Cards, QuickView, Tip-of-the-week, Workbench Guide, and Training Guides. Both HTML and PDF versions of all documentation were available on the web site.

Jan 1999Jun 1999

Principal Technical Writer

On Technologies

Wrote documentation for a programming language embedded within their remote software installation product.

Dec 1995Jan 1999

Principal Software Writer/Publications Manager

NobleNet
  • Created the first version of this company's web site.
  • Wrote documentation for NobleNet’s COM/CORBA middleware API and nearly all of the company’s RPC middleware. (All APIs are in C or C++.)
  • Created HTML documents for company web site using FrontPage. Pages used standard technologoies such as Perl-based CGI and JavaScript.
  • Supervised other writers and contractors (including artists and editors)
  • Created Web Works Publisher-based converter that allowed simultaneous creation of HTML and printed documents written with FrameMaker. Used Acrobat to create PDF documentation. Used RoboHelp to create Windows help files.

Projects

Nouveau Reference: Objects and Functions, Nouveau Reference: Transport Objects, EZ-RPC Programming Guide, RPC 3.0 Programming Guide, RPC 3.0 Functions Guide, RPC 3.0 Environments Guide, NobleNet Web Guide. Help files for Windows-based applications.

Nov 1992Nov 1995

Senior Programmer/Lead Technical Writer

Lead Technical Writer

  • Wrote all ELF documentation. (ELF is similar to Visual Basic.)
  • Won STC Award of Distinction for writing a major part of the help documentation.

Software engineering

  • Created software tools that enhance writer productivity.
  • Designed and programmed the hypertext software for Applix’s UNIX-based office automation suite.
  • Designed and programmed the second version of Applix’s internal help desk software.

Projects

ELF Quick Reference, Words Macros, Spreadsheets Macros, Mail Macros, Graphics Macros, Data Macros, Base Macros, Applix Words Technical Reference

Jun 1992Nov 1992

Contractor

Sequoia
  • Rewrote SQL documentation.
  • Designed the FrameMaker-based templates for all of Sequoia’s documentation.

Project

FT/SQL Guide

Oct 1991Jun 1992

Contractor

XEROX ADVANCED INFORMATION TECHNOLOGIES
  • Designed and wrote documents describing the C-based API to the Xerox object-oriented document management system.
  • Examples created for the documentation became the basis for the QA group test harness.

Project

XDOM Programming Guide, XDOM Pocket Guide, XDOM Training Guide,XDOM Reference Guide.

19921992

Contractor

NobleNet, Inc.

Wrote documentation for initial release of an RPC code generator/CASE tool.

Project

EZ-RPC, Version 1

19921992

Contractor

Gold Hill Computer

Added enhancements to Lisp reference documentation; these enhancements included the Common Lisp Object System.

Projects

Lisp Reference Manual Updates, CLOS and Loop Macro Reference.

19911991

Contractor

Documented a programmable quality assurance tool that allowed testers to define window events and play them back. This tool used CPP and ran under OpenWindows.

Jun 1988Jul 1990

Contractor

Wrote functional specifications and internal documentation for Lotus’ OS/2 version of 1-2-3; specifications included end user interactions and API.

Projects

1-2-3/G File Format Manual, 1-2-3/G Functional Specification and Addenda, SPR Utilities Manual, 1-2-3/G Error Help, Desktop System Services Manual (draft) Collaboration: Lotus/DBMS Functional Specification.

Jan 1987Jun 1988

Member, Technical Staff

Stellar Computer

Wrote all programming language and graphic documentation for a UNIX-based graphic workstation/mini-supercomputer. Co-authored the rewriting of UNIX documentation so that it was specific to Stellar’s proprietary implementation. Other duties included document design, editing, and production.

Projects

PHIGS+ Reference Guide, PHIGS+ Programming Principles, XFDI (Graphics) Guide, Site Preparation Guide. Collaborations: Stellix (UNIX) User’s Guide, Stellix Programmer’s Guide, FORTRAN Reference Guide, FORTRAN User’s Guide, C Reference Guide, C User’s Guide.

Mar 1980Jan 1987

Engineer/Manager/Writer

Principal Software Engineer

Designed and implemented (in a Lisp dialect and Prime’s internal programming language) commands and subsystems for the EMACS programmable editor

Section Manager, Lead Writer, and Senior Technical Writer

Led the Data Management and CAD/CAM Technical Publications group; this group had 21 people. Departmental budget was slightly more than $1,000,000. Had functional managerial control over the Stevenage, U.K. CAD documentation group.

Projects

DBMS/Query Reference and User Guide, DML Reference Guide, EMACS Extension Writing Guide, PST 100 (terminal) Programming Guide. Collaborations: TAPS Reference Guide, DBMS DDL Reference Guide, EMACS Reference Guide, CAD system administration literature, Preliminary Technical Updates, Minor Release Updates.

Work Samples

Operating Systems and Tools

Linux and UNIX on many architectures, Windows, as well as many other proprietary systems.  Expertise in writing tools such as FrameMaker, Microsoft Word, and others. Able to use drawing tools such as Adobe Photoshop.

Other Information

Gave introductory webinars to prospects. Gave other webinars as required.

Was responsible for major improvements in writing methods and training, and project planning. Directed methods research aimed at placing CAD documentation methods and processes on a professional footing.

Traveled to customer sites to evaluate how documentation was actually used.

Taught educational workshops to Prime Computer’s data management and CAD field specialists.

Reviewed manuscripts for John Wiley.

Have contributed material to a textbook on database management.

Gave DBMS presentations to potential customers.

Testimonials

After reading this chapter and browsing through the rest of the CLI documentation, I have to admit that I'm a bit overwhelmed. I really enjoyed the humor and the cheering up comments in this text ("Managing Chaos", "It will get clearer."). It is the first time that I thought in clear terms about the problem of deciding programmatically, which processes and threads have to run freely if other processes/threads are stepped or executed until reaching a goal.  ----------------------------------------------- I like the memory basics stuff. We make VME hardware and often have problems in explaining the basics to our customers. Thank you for this refresh. Would we be allowed to reuse some of this in a FAQ for our own customers?  ----------------------------------------------- Just wanted you to know that I think your tips are great.  I teach Cray applications classes and also do some work at the University of Tennessee. I recommend that all my Cray students sign up for your tips of the week because they often cover exactly what they need to know. I also forward your tips sometimes to the students at UT that work with me because the explanations are so very helpful - especially with the diagrams. Thank you for your excellent work! ----------------------------------------------- Barry, I like the fact that he thinks there are multiples of you! Good work. Chris > I've been all thumbs knowing where to push which buttons and such -  though I am reading the manuals and making headway.  Your doc writers  have done a tremendous job!  Please pass along to them at their doc organization and content is right on.  -----------------------------------------------

I can't thank you enough for the tip. I was asked a question on an interview to add a few lines of code that will let me use a b[i][j] notation on a dynamically allocated 2D array; I was supposed to dynamically allocate it. After 8 hours working on the problem at home, I came close to it and couldn't figure out why it's crashing, but after I read your article and implemented the tip, it worked like a charm. I might be able to land a job and the credit will go to you.

Thank You! ------------------------------------------------Barry, Your new memoryscape doc was a big hit with the French reseller. He said it was a perfect model for going into schools and promoting the product, especially the way it was written. BTW - we 'sold' out all cc's of the doc sets we bought for the workshop and have requests for more. Kudos to you.

Education

Ph.D. 1977. Bowling GreenStateUniversity.

M.A. 1971. University of Connecticut.

B.A. 1969. University of Connecticut.

Summary

Locating a  challenging position documenting products, user and programming guide , and APIs for technical and expert audiences. Ideally, the position  would require my skills in web programming and converting documentation into HTML and help.Locating a  challenging position documenting products, user and programming guide , and APIs for technical and expert audiences. Ideally, the position  would require my skills in web programming and converting documentation into HTML and help.

Programming Languages

Use PHP, Javascript (standard programming as well as DOM scripting for creating dynamic HTML and web pages, limited AJAX), and Perl.

Can read Java, C, C++, COBOL, Fortran, Lisp, and PL/I.