Portfolio
Here is a representative sample of writing by Robert Nagle (both professional and personal).
Hardware & Software Manuals
- Community-based documentation: In 2008 I wrote 2 lengthy tutorials for the Plone open-source community. Its purpose was to talk about how my company’s software could be used when deploying open source software.
- Best of Show: (These were help topics I wrote about extremely technical and complex subjects).
- Troubleshooting Checklist . This exhaustive document helped customers to diagnose problems. The support staff uses it to solve customer tickets.
- User and Server Security. This reference guide helped customers with user security and installation problems.
- Caching Concepts & Strategies: General introduction to how caching with the company’s product improves Plone performance. With diagrams.
- Online Help: HW-SW Connectivity, Adaptive Help Window, Adaptive Help Window (integrated view), Quick Start Installation Instructions, Application Server Troubleshooting, New Software Features, Document Table of Contents . (For more, see the 3 examples of Table of Contents which link to live documentation).
- Table of Contents: Example 1, Example 2, Example 3. These links not only demonstrate how I organize information, they also link to about 100+ additional help topics (all created by me).
- Diagrams: 2 Diagrams about Trusted Proxies, Online Manufacturing Tutorial (multipage web tutorial for SW and Manufacturing Engineers), Manufacturing Processes (produced for a training class), Diagnostic Procedures (Use Cases gathered for a new SW tool)
- Software Screencasts/ Web Demos. These were produced using Adobe Captivate.
- Setting up Virtual Hosts for Apache on MS Vista. I posted this little tutorial on an online forum. Truthfully, I just wrote this for fun after realizing it was documented nowhere else.
Marketing/Promotional Technical Documents
Book Production and Design
- Plone Book . I had to polish the English translation and do a technical review of this book (which was originally written in German). Download it here.
- For early 2010 I’m writing a revised edition of the Plone Book, writing it substantially and producing it using Docbook XML and XEP Rendering Engine.
Renewable Energy/Investigative Reporting
In November 2009 I published two investigative pieces titled, “Is your website green?” about data centers for the Houston Chronicle technology blog.
- Part 1 covers how to estimate the carbon impact of a website or data center.
- Part 2 examines how to estimate energy efficiency of data centers and whether the new federal Energy Star rating system will bring improvements in the IT sector.
Posters/Presentations
- Posters for 2007 NIJ Conference: Sample 1 (PDF-580K) , Sample 2 (PDF- 2mb)
Reporting on Legal Topics
Feature Stories
- Technology Conference Reporting (2004) (10 stories on Houston Chronicle’s technology blog about South by Southwest Interactive)
- Are Meetings Really Productive? (2002) (humorous essay about business meetings)
- Book Clubs, Amazon.com and Social Networking (2006)
- 11 Incredible Music Albums you can download for free (2009). Long feature story about free music, plus several related interviews.
- Cheap Man’s Guide to Podcasting and Audio books (2006)
Analysis & Commentary
- Ebooks, Amazon.com and Chump Change (2004) (Business & Publishing)
- Book Reviews on Slashdot.org (2002-2005: Art of Unix Programming, Two Books on Plone, Managing RAID on Linux , Using Staroffice/Open Office, Professional Apache 2.0. Also Digital Video Hacks (published on dvinfo.net)
- Straight talk about graduate school (2004)
Educational Topics
- Digital Game-Based Learning(2001) (commentary and book review published on slashdot.org)
- 4/2007 UH Presentation on Ebooks (PDF)
- Enrichment Games and Instructional Design. Paper I wrote for an Instructional System Design graduate class at UT Austin in 2001.
- Sample Foreign Language Lesson Plan (PDF, 1998). Published in a newsletter for English language teachers.
Publishing
Technical Writing Topics
- Why readers don’t read documentation: technical writing secrets (2007)
- Job Interview Test (2009). Insights about technical writing gained from a job interview.
Miscellaneous/Humorous
- Tutorial: How to Control the Crap which appears on your Facebook Wall (2010). Part rant, part tutorial.
- Are Meetings Productive?(2001) A humorous look at meetings at an IT company.