How to Build a DITA XML Technical Writing Portfolio

... and demonstrate your skills in technical writing using DITA in Oxygen XML Author. You can get that job interview!

4.77 (15 reviews)

How to Build a DITA XML Technical Writing Portfolio


1.5 hours


May 2021

Last Update
Regular Price

Blue Host
Fast, easy, and secure WordPress hosting in minutes + 1 free domain name

What you will learn

How to Share Your DITA XML Writing Portfolio in Your Resume


Do you wonder how you can demonstrate technical writing skills using DITA XML? Do you wonder how to make your resume (CV) shine compared to other technical writers' CVs and YOU get invited to the job interview? 

As a technical writer, you want to demonstrate your DITA XML technical writing skills to impress the recruiting manager and get invited to the job interview.

If you are a student, who just wants to start in this field, I am sure you get frustrated every time you see in the job ads "3 to 5 years of experience wanted" or "provide technical writing examples from your previous work". 

How can you possibly do that if you never get the job in the first place?! How can you start your journey and land the dreamed technical writer job in the software documentation development world, if they never give you a chance?

Well, my answer to that is simple - you need to design and develop your own technical writing portfolio. You must proactively approach it and focus on the skills you want to demonstrate to your desired employer.

In a world dominated by software development skills demand, you must know what to do to provide software documentation for the users!

My name is Jordan Stanchev. I've made my career in the field of technical communications with a strong focus on technical writing and information architecture, and writing using DITA XML over the last 20 years.

I practice what I teach as a part of a Fortune 500 company as a User Assistance Development Architect. I'm also one of the founders of the JPDocu School of Technical Writing where we help students like you learn the skills need to become successful technical writers.

In this course, I will show you the steps you should follow to:

  1. Prepare your DITA XML writing portfolio and

  2. Share it publicly to demonstrate your DITA XML technical writing abilities.

By the end of this course, you will be able to:

  • strategically approach your technical writing project for any software app;

  • organize your documentation structure in a DITA map;

  • write the sequence of steps for the end-users using a DITA Task topic type;

  • write the conceptual, background information for the end-user using a DITA Concept topic type;

  • share your documentation sources in a GitHub repository;

  • visualize your ready-to-be-published documentation for the end-user via GitHub.

This course is for you if you are a technical writer who wants to build a portfolio and use it to advance your career as a DITA technical writer in a corporation or as a freelancer.

To be able to successfully complete this course you must have at least a basic understanding of:

  • technical writing

  • structured writing

  • what is DITA XML

If that is you, I welcome you to this course! 




Installing a Tool for Writing with DITA

Choose Your Tool for Writing

Installing a Tool for Writing with DITA

Installing Oxygen XML Author

Lecture 7: Steps to Success

What do you need to succeed?

Project Goals

Assumptions and Limitations

Installing Oxygen XML Author

Create a GitHub Repository

Project Plan: What Shall We Document?

Project Plan: Writing Phases!

Phase 1: Writing!

Which Are the Tasks to Document?

Sample Content: Writing the Steps of the Tasks

Demo: Create a DITA Task

Add Supporting Concepts

Sample Content: Writing s Supporting Concept

Demo: Create a DITA Concept

Phase 2: Generate output!

Pre-Production: Share Your DITA XML Source Files in the Repository

Demo: Upload DITA XML Source Files to GitHub Repository

Production: Generate Output from DITA XML

Demo: Generate PDF and HTML5 Output from DITA XML

Phase 3: Share the Content With the End Users

Share Your PDF Output Using the Publish GitHub Repository

Share Your HTML5 Output



Rebecca10 July 2021

This course delivers on its promise to teach you how to successfully use DITA through the Oxygen XML Author application. I feel that I have gained a strong enough understanding to continue learning more advanced features of Oxygen on my own, because this course provided a great base for me to build my knowledge on.

Harsha6 May 2021

the information was informative but very less, could have provided this information in "Technical Writing: How to Write Using DITA XML" course itself.

Suman4 May 2021

This course is fabulous. Instructor Jordan Stanchev is a top-notch trainer, no doubt. The courses from JPDocu School of Technical Writing is well designed and effectively delivered. I learnt all the essentials of DITA and software documentation effortlessly from here. Thank you so much for sharing this valuable skills and knowledge at affordable prices.


5/3/2021100% OFFExpired


Udemy ID


Course created date


Course Indexed date
Course Submitted by