Describe a strategy for using topic elements in the context of a specific topic Name the most commonly used DITA topic elements (DITA tags) Do not let the diversity in tags and the huge number of DITA capabilities confuse you.Īll you need to write your first guide is a strategy (what you want to deliver) and a set of simple steps to follow to construct your guide (explained in this section of the course)! Reference topics in a map to construct a deliverable (user guide) using Oxygen XML Author Create the 3 most frequently used DITA topics types: Task, Concept, and Reference Apply the 5 steps for creating the content of a user guide Content can be personalized, and so on.īy the end of this section you will be able to: Automatically generated various outputs from the same DITA source ![]() It implies strict rules for writing, no matter who the technical writer is! Today you cannot be a modern technical writer if you do not know how to write software documentation using DITA XML! It's the de facto standard XML for writing! You must know and spell out the benefits of DITA, and be sure, on a job interview you will be asked why DITA is so important. Just spelling out the benefits of writing in DITA takes a lot of time! There are so many reasons why DITA is getting more and more popular. What are the benefits of writing software documentation using DITA Section 10: Customizing DITA XML Output - 60 minīy the end of this section you will be able to explain: Section 8: How to Create Interactive Images in DITA - 80 min Section 7: Information Architecture for DITA Authors - 90 min Section 6: Information Architecture for Technical Communicators - 50 min Section 5: Profiling (conditioning) Content in DITA - 60 min Section 4: Reusing Content in DITA - 50 min Section 2: 5 Quick Steps to Writing in DITA XML - 50 min How much time does the course take? In short: If you are looking for a quick start into DITA, consider the basic DITA course 'A Quick Start to Technical Writing with DITA', which is for technical communicators, that are not yet familiar with DITA. The course further deep dive and elaborate the basic concepts and knowledge introduced with the course ' A Quick Start to Technical Writing with DITA' and then provides more advanced details and strategies such as reuse of content and personalization of content based on profiling strategy. I recommend that you take one section a day at most, to avoid being overwhelmed and manage to perform each exercise described. It will take you around 8-10 hours from the start of this course just to go through this material! It comes with lots of various hands-on exercises, examples, and advice based on my practice. It is based on the online DITA XML training I've been providing to my students at the university. The course ' How to Write Using DITA XML" is designed for intermediate to advanced-level technical writers who want to deep dive into the capabilities offered by DITA, create complex and personalized user guides, and deliver this single-sourced output using the Oxygen Author tool into various delivery channels. People manager, managing technical writers in the team Knowledge of DITA is relevant for you if you are involved in any way with software documentation as a: To achieve the ultimate career goal, all you do need is to learn writing using DITA! You wouldn't believe how often I hear back from my students about how the knowledge from this course is what made the breakthrough in their DITA technical writer job interview and helped them advance their careers! ![]() And this is what I focus on in this course.īased on my experience, what I can tell you, is that for a modern technical writer looking to build his or her career in the field of technical communications, knowing DITA XML simply is a must! What can I say, I have vast experience to share in structured writing and information architecture using DITA XML. I constantly have to write software development specifications and project documentation, in addition to the user guide. I also chair the experts' group of our nearly 300 people strong group of DITA information architects in a Fortune 100 company - SAP SE. The technical writers' community we serve is more than 1000 authors. Today, I am a part of the team that leads the development of DITA XML-based infrastructure projects. ![]() ![]() The software products I have worked on are in the field of security, messaging services, and development infrastructure (such as GitHub and SAP NWDI). I have written thousands of pages of software documentation guides for administrators and for developers. Starting off as a Java developer, I have then become a senior technical writer and had built a career as a DITA information architect. I have built my career in the field of technical communications over the last 20 years. Do you want to learn how to write structured documentation using DITA XML? If yes, I can help!
0 Comments
Leave a Reply. |