I help high-tech companies cross the chasm by making their products easier to use and learn

I use my knowledge about the market, product, and users to gather requirements, test builds, ensure UI, CLI, APIs are easy to use, and deliver documentation and training products.

My ultimate goal is to put myself out of a job by helping create products that require no documentation.

Work Experience

Tech Writer

Docker (2016 - today)

I'm the documentation lead for Docker Datacenter.

I work on all stages of the product development to ensure Docker Datacenter is easy to use and learn:

  • Gather requirements;
  • Build and test the product to report bugs or usability problems;
  • UI writing;
  • Ensure UIs, CLIs, APIs are consistent and easy to use;
  • Create user-story driven documentation;
  • Create CLI/API/SDK reference documentation.

I help to shape the team processes, roadmap, and hiring interviews.

I know I can't achieve much alone, so I collaborate closely with engineers, designers, product managers, support, marketing, and end-users to help Docker Datacenter cross the chasm.

Check what I built

Academy Engineer

OutSystems (2011 - 2015)

I lead, implement, and ship technical writing projects with minimal supervision. For this, I interact often with engineers, product managers, and end-users.

I'm responsible for creating and improving customer-facing:

  • Reference documentation for development tools;
  • API/SDK documentation;
  • User-story driven documentation;
  • Online training;
  • On-site training materials;
  • Certification exams.

I also work closely with the development teams to ensure OutSystems Platform requires almost no training or documentation. For this I help:

  • Review APIs/SDKs to ensure they're easy to use;
  • Review UI copy that goes into the product.

I help shape the team day-to-day processes, long-term roadmap, and hiring interviews.

Check what I built

Intern Software Engineer

OutSystems (2010 - 2011)

Completed my Master's thesis at OutSystems: Softening the Learning Curve of Sotware Development Tools.

The thesis addresses the problem: "I'm building an IDE (or any other complex software tool), how can I make it easy for first-time users to learn it?"

It discusses several alternatives to guiding users such as: help files, video tutorials, discussion forums, gamification and intelligent tutoring systems. It also explains how each of them can be used to assist the learner transitioning from novice to expert.

As part of the thesis, I've extended OutSystems Platform IDE embedded tutorials, in order to:

  • Capture learning metrics and adapt the level of assistance provided;
  • Present questions during the tutorial to make sure the learner performed a self-assessment.

During the internship I've also participated and led several usability tests, that led to direct improvements on the product.

Check the abstract

Education

MSc, Multimedia and Intelligent Systems

Instituto Superior Tecnico (2009-2011)

Finished with 17/20 a MSc in Computer Science, majoring in Multimedia Systems with a minor in Intelligent Systems.

Majoring in Multimedia Systems allowed me to attend a Human-Centered Design course, and made me understand that Games and UX have so much in common.

I learned what it takes to be a Game Designer and a Game Developer.

In the Intelligent Systems minor I learned the importance of thinking of different strategies to address a problem. Sticking with the first good enough might cost you in the long run, or in AI terms, you might have found a local maximum.

I had read the Mythical Man-Month by now, so I decided to take a course on Project Management (big mistake, since the focus was on waterfall methodologies).

I was also starting to get curious on what it takes to manage and scale a company or team, so I took a course on Organizational Architecture.

Check what I built

BSc, Computer Science

University of Madeira (2006-2009)

Finished with 14/20 a BSc in Computer Science.

This was where my interest for usability was born. Sometime after finishing a course on Human-Computer Interaction, I attended a talk by Don Norman. At first the talk seemed superficial, but looking back, it made me buy the Design of Everyday Things. Reading it was like drinking knowledge from a firehose.