Brett Terpstra

Profile

I’m a writer, podcaster, and software developer with over 25 years of experience in writing, documenting, and marketing software. I’ve worked in HTML/CSS, JavaScript (vanilla, jQuery, Angular, React, Vue), C/C++, Ruby, Objective-C, Swift, Python, and more. I have extensive experience writing documentation using Markdown with Git version management and publishing pipelines.

I graduated from the Minneapolis College of Art and Design in 2000, with a BA in Interactive Multimedia (Web Design). After working as Art Director and webmaster for a fashion company and subsequently founding my own advertising firm, I went full-time into web development. I began working for Aol Tech (Engadget, TUAW, Joystiq, Massively) in 2011 and rose to Senior Front-End developer and tech lead for the content division. I left that position after five years to be an independent software developer for seven years before taking on a Developer Relations role at Oracle in 2021.

I am currently working as a Principal Software Developer for Oracle on the Developer Relations team, with a technical writing focus. I maintain my personal projects, including multiple applications and their documentation and support, as well as writing, blogging, and podcasting.

Experience

Oracle
Principal Technical Writer • May 2021 – January 2022
Principal Software Developer • January 2022 – Present
I started at Oracle as a technical writer. My work creating a GitHub->OCM (Oracle Content Management) pipeline using Jekyll as a conduit earned me a promotion to Principal Software Developer. The pipeline allows Oracle writers to compose in Markdown and use GitHub Pull Requests for the editing process, leveraging code comments, suggested edits, and providing an audit trail. I serve as the primary editor for my team and am always the last approval in the process (though I’ve built it such that another writer can easily step in if I’m unavailable). Once a PR process is complete, the Jekyll site is published, and the OCM automation (which runs as a Jekyll plugin) pushes new and updated content to the CMS.
I manage the Oracle DevRel GitHub organization for the company, responsible for creation and maintenance of over 200 repositories, including their automation pipelines. I’ve developed tools for repo generation from templates, and for batch updating files and Actions across any/all repos using the GitHub API.
In my role as Principal Technical Writer, I managed projects and goals for my team, and took on the role of editor and facilitator for the work of my co-workers, though not officially in a management role. Under my leadership with a team of three, we published over 100 pieces of technical content that were surfaced as part of developer.oracle.com and blogs.oracle.com in the course of one year.
Independent
January 2014 – May 2021
For seven years I developed several commercial Mac applications, including Marked 2 and the upcoming nvUltra, and maintained multiple web properties. I contracted for web development, productivity consultation, and — in addition to blogging and creating documentation for my own projects — contributed to several online publications including MacStories and Lifehacker (and previously Macworld and TUAW), as well as continuing my own blog at brettterpstra.com.
Aol Tech
Contract developer • July 2009 – March 2011. Senior Front End Developer • March 2011 – January 2014
I worked remotely on the front end of Aol Tech web properties as the lead developer for Engadget, TUAW, Joystiq and Massively. I handled the implementation of all JavaScript, HTML and CSS technologies on these blogs, and built new functionality for the core Blogsmith platform through PHP extensions. I managed a team of four people to bring major projects like the relaunch of Engadget to fruition.
I worked closely with designers and had an active role in the development of several high-traffic properties.
This is where I developed my skills as a remote employee. I learned to manage time, work and meet across time zones, and provide accountability without being in an office setting. I implemented the use of Asana to track projects and progress for my team, as well as the use of Basecamp for communication.
Agilebits
Chief Media Producer • October 2010 – February 2011
Hired as a polymath. Built and maintained company sites in both PHP and Ruby on Rails, as well as handling PR, blogging, and support tasks.
The Unofficial Apple Weblog
Author/Blogger • 2007 – 2011
While blogging at TUAW, I developed the Blogsmith Blogging Bundle for TextMate. The CMS hacks that I pulled off while at TUAW led to my employment as a developer for Aol Tech.
Circle Six Design
Owner • January 2006 – February 2009
Web design/development, print design, audio/video production, and client management.
Knitcraft/St. Croix
Art Director/Web Developer • July 2001 – December 2005
Handled international e-commerce and web branding, and created all artwork for the national chain of boutique shops.
Other
As a member of the Mac “power user” community, I’ve spoken at ALTConf, Macworld, and Macstock, organized meet-ups at WWDC, and have published two titles on iBooks.

Education

Minneapolis College of Art And Design, Minneapolis, MN
BA Interactive Multimedia, 2000

Skills

Summary
Programming
I have a core set of languages in which I consider myself proficient (Ruby, Objective-C, Swift), and myriad languages I’m comfortable working in and always learning more about. I’m capable of picking up new languages quickly as needs arise.
Writing
I have strong English language skills, spoken and written, bridging both grammar and style. My writing is both technical and approachable in nature, and I’ve been credited by many new programmers with having provided them an accessible entry point to a concept. I internalize any style guide I’m given and can easily write for the target publication.
Markdown
I’m extremely proficient in Markdown. I can tell you every difference between MultiMarkdown, Discount, Maruku, Kramdown, PHP Markdown Extra, GitHub Flavored Markdown, and any other flavor of Markdown. I know how to write Markdown that will translate across platforms and processors, and how to leverage the specific strengths of any Markdown processor.
Leadership
I work well with others, and naturally take a leadership role. In times when that leadership role has led to a management position, I’ve done an excellent job of hearing the needs of my reports, guiding them in their projects, and acting as a conduit between upper management and my team to accomplish large goals on time. I have experience with Agile workflows.
I communicate well, whether in email, one-on-one, or in meeting settings. I accept criticism, understand goals, and convey my feelings and opinions easily.
I will say what’s on my mind, but am careful not to hurt others, and am very aware of differing needs within a team. I have often been told after meetings, “Thank you for saying that, I didn’t have the nerve.” I wear this as a badge of honor.
Over the years I’ve developed help documents for projects like Marked 2 (documentation), Bunch (documentation), and all of my various projects, ranging from detailed README files to full websites. I’ve also developed documentation for other applications, including Fantastical by Flexibits.
I’ve contributed to several major publications, including O’Reilly’s Mac Hacks, and co-authored the interactive books 60 Mac Tips Volumes 1 and 2 for Apple’s iBookstore and Vimeo release.
I blog regularly and have developed an audience (30k+/week) with whom I enjoy interacting. I’ve also published work on The Unofficial Apple Weblog, Macworld (print and web), MacStories, and LifeHacker, as well as contributed to the upcoming Terminus project for Warp.
Git/GitHub
I use Git for version control on all of my projects, and GitHub hosting for all of my open source work (and some private repositories). I’m well-versed in command line Git, apps like Tower and GitKraken, and have experience using GitHub Pull Requests, Issues, and Discussions. I also have experience developing GitHub Actions as pipelines for CI/CD and automation.

Activities

Coding
I develop the Mac application Marked, a tool for authors and bloggers with Markdown preview and text analysis features.
I created and maintain Bunch, an automation tool for Mac, the documentation of which I am particularly proud.
I authored the nvALT fork of Notational Velocity and am currently working on its successor, nvUltra.
I spend my free time coding automation and productivity apps and scripts. I have myriad open source tools I’ve authored and supported, including Doing (command line project/time tracking), mdless (a command line Markdown pager), the MarkdownEditing package for Sublime Text, and NA (command line interaction with TaskPaper files).
In the process of documenting my projects, I’ve built helpful tools like NiftyMenu and a Keyboard Maestro macro for cross-linking Markdown documents.
I love problem solving, and find complex regular expressions a relaxing endeavor.
Music
I enjoy blending music and technology, and do a lot of home recording. My punk rock tour days are behind me (videos available upon request), but I continue to enjoy the process of composing and the technical details of production.

References

Professional and personal references are available and will be furnished upon request.

Elsewhere

GitHub github.com/ttscoff
Twitter twitter.com/ttscoff
Mastodon nojack.easydns.ca/ttscoff
Blog brettterpstra.com