Links
Archives
Terms
- API: Application programming interface
- SDK: Software developer's (development) kit
 |
INFORMATION DEVELOPER
San Jose, CA Working through |
Ellen's technical writing (and related) contract history at ESI
Friday, June 20, 2003
2000
| Quadralay—Provided WebWorks technical support to company's customers. Quadralay tests independent consultants for their knowledge of WebWorks Publisher and hires qualified consultants to assist their technical support department with heavy loads of customer questions. I provided part-time support, typically 3-5 questions a week, via e-mail until my schedule no longer allowed time. (Independent of Expert Support.) (2000: 5 months) |
1998-2001
A large semiconductor company (projNum)& #151;Summary. CompanyDesc. ProjDescription
xx pgs. FrameMaker, Quadralay WebWorks Publisher, Snagit, Java, Javascript, HTML hacking. (fall 1998-fall 2001: 3 years, including first year at NetBoost) Served as tech pubs project lead; served as pseudo-manager until company hired its own. We were this division's complete tech pubs department. Tasks, responsibilities, projects inluded the following:
|
2001
| General Magic (06-07)—Created new Voice-XML and JSP API programmer's guide and reference. (See previous General Magic project for description of company and API.) Worked with another senior writer to create new programmer's guide and reference for API. Edited other writer's work and provided developmental guidance. Worked on reference entries, conceptural overview, and detailed how-to chapters. Required rapid learning curve and reworking of project scope and schedule. Also figured out how to improve screen shots and graphics. Delivered in PDF. 260 pgs. FrameMaker, Adobe Acrobat Distiller. (Fall 2001: 3 months) |
| ClientName (projNum)& #151;Summary. CompanyDesc. ProjDescription xx pgs. Xxtools. (year) |
Thursday, June 19, 2003
2002
| WebEx (10)—XML and URL/argument API reference manuals. The company provides tools and services for Internet meetings, conferences, and training. Their APIs allow clients, primarily third-party remarketers of the services, to manage users, accounts, sessions, and attendees for Web-based activities. Updated existing versions of integration, user, and reference manuals for three products that provided API access to the company's tools and services. Documented features also included uploading and downloading, recording of online sessions, and others. API languages include commands activated using URL command-line arguments, and XML using XML schemas. Also fixed problems in the existing FrameMaker template. Delivered in PDF. 588 pgs total. FrameMaker, Adobe Acrobat Distiller. (fall 2002: 2.5 months) |
| General Magic (08/09?)—Voice-XML and JSP API reference manual. The company provided telephony tools that allowed customers, primarily large companies, to develop applications to automate the handling of incoming calls, such as requests for support, product information, branch locations, and so on. The API included predefined grammers; sets of voice prompts; and "talklets" (along the model of applets) to perform typical voice operations, such as user authentication, list browsing, J2EE email browsing and authentication, and prompting for addresses, phone numbers, dollar amounts, and credit cards. The talklets, implemented in Java Server Pages (JSP), generated Voice-XML (VXML) that interacted with voice gateways. Customers could customize the talklets or create their own. Worked with another senior writer to add new features and update old material in an existing reference manual and to add information about a new debugging tool. Required coming up to speed very rapidly on several areas of new technology. Also required converting graphics to and from various formats, including BMP, WMF, GIF, VSD. 250 pgs total. FrameMaker, Visio, graphic converters, DeBabelizer. (Summer 2002: 2 months) |
| Celera Diagnostics (01)—Procedures and specifications for biotechnology diagnostic products. Researched and wrote procedures for such things as packaging products for shipping. Converted old specifications for the manufacture, QA, and labeling of biotechnology products into new, standard, consistent formats, working with product engineers to get latest measurements, quantities, equipment, test procedures, and so on. MS Word. (2002: 5 months) |
| BD Biosciences (03)—WebWorks Publisher troubleshooting. Pubs department occasionally calls with WebWorks customizing or troubleshooting issues that they don't have time to work on because of imminent deadlines. I help figure out what the issues are and suggest (or implement) solutions. Quadralay WebWorks Publisher. 2000?-2002 (1-3 days each) |
| WebEx (09)—XML and URL/argument API reference manuals. (See previous WebEx project for description of company and API. ). Rewrote and updated convoluted, badly organized and badly written existing, unreleased user guide and two reference manuals (550 pgs total ). Required interpreting content of existing manual and asking extensive questions of technical contact, many of which they also had to research. Created new smaller guide and reference for less-technical customers (32 pgs). Delivered in PDF. FrameMaker, Adobe Acrobat Distiller. (spring 2002: 4 months) |
2003
| Adobe (40)& #151;Create user's guide for graphical-data-to-PDF API for 3rd party scanner manufacturers. Adobe creates products for desktop publishing. C API allows third-party scanner manufacturers to scan pages (or take graphical input from any source) and create high-quality (or high-speed) PDF files based on a large quantity of possible options. Started with a short existing tutorial and a rough but extensive reference manual, all written by software engineers. Using Adobe FrameMaker template, create user guide including tutorial getting 3rd-party scanner software developers up to speed on the basic concepts. Options included various image-processing filters and conversion specifications. In addition, engineers had implemented a C++ sample application (and C++ interface to C API) that included code and tools that they recommended their customers use as a base for constructing their own applications, so had to explain the application and its code. 140 pgs. FrameMaker. (Oct-Nov 2003) |
| Meru Networks (1)& #151;Documentation set for wireless networking API. A startup company that produced easily configurable wireless networking devices. Working with another writer, designed documentation set including hardware installation, release notes, command reference manual, quick start, and system admin guide. No existing documentation and product being designed and redesigned as we worked on the docs. Proprietary command-line interface (basically UNIX-like in some ways) to do such things as configure RADIUS security, set up channels, define and monitor network topology, set up 802.11 interfaces, configure QoS, and so on. xx pgs. FrameMaker. (July-Sept 2003) |
| DoCoMo USA Labs(2)—Training engineers to write better. The company produces white papers and articles based on research. Researched, created, and taught a 6-hour course (divided into 4 session) for nonnative-English-speaking engineers on how to improve writing skills. (-Aug 2003) |
| Aplia(2)—User guide for web-based course-design and -management software for economics professors AdddetailedDesc xx pgs. MS Word. (Jul-Aug 2003) |
| Celera Diagnostics (02)—Style guide.Created a style guide for the labeling of biotechnology products. 10 pgs. MS Word, Adobe Acrobat Distiller. (2003) |
| Ricoh Silicon Valley (05)—User's guide and reference for Java SDK. The company builds office equipment such as copiers and scanners. Created a user's guide and reference manual for a software development kit (SDK) for a copier/scanner. The SDK contained a Java API and a software emulator of the copier/scanner hardware. The API allowed developers to create embedded copier applications including graphical user interfaces (GUI) for the copier's LCD screen, button-handling routines for the hard buttons, and routines to handle input from the copier/scanner. Required editing screen shots and converting BMPs to GIFs. Delivered doc in PDF. Edited extensive source code—packages, objects, methods, and arguments—and created supplementary files to include Javadoc (and HTML) comments for the automated generation of online documents. 108 pgs (plus source code). FrameMaker, Adobe Acrobat Distiller, graphic converter, Snagit, and Javadoc. (2003) |
| Ricoh Silicon Valley (04)—User's guide and reference for C/C++/Visual Basic SDK. The company builds office equipment such as document management systems. Updated audit trail and group/user features in a user's guide and reference manual for an SDK for a document-management system. The SDK contained a C/C++/Visual Basic (COM object) application programming interface (API). The API included calls to do such things as manage user and group access, add documents, fetch documents, search through documents using a proprietary query language, manage folders, define and manage fields of information available for documents. Delivered in PDF. 382 pgs total; 45 pgs updated. FrameMaker, Adobe Acrobat Distiller. (2003) |
Sunday, June 01, 2003
Education
| Ellen also dabbled briefly in becoming educated, attending: |
