Are you confused and overwhelmed by the number of elements you need to learn as a DITAXMLtechnical writer?Do you wonder which are the elements you must use to simply write your software documentation fast? Or you simply need a refresher on which are the most often used elements in DITAXML?
If yes, this course is for you!
If you are a technical writer, looking to improve your knowledge and skills related to DITAXML, you should know the DITAXML map and topic elements well.
JPDocu School of Technical Writing has providing instructor-led and self-paced courses on technical writing, DITAXML,and information architecture to thousands of students worldwide. In this course, Jordan Stanchev, User Assistance Development Architect at a Fortune 500 software development company, is sharing his vast knowledge in DITAXMLand Oxygen XMLAuthor.
One of the major challenges authors have with DITAXML is the sheer amount of elements that you have to learn just to start writing. There are currently initiatives happening in the OASIScompete that define the DITAstandard to simplify and reduce the number of elements you can use (Lightweight DITAXML project).
But is that really needed?Will it help you when you have a more complex scenario to document?
If you are a DITAXML technical writer, you should know the most frequently and commonly used DITAXML elements from DITA1.3 specification. The consequence of having this knowledge will be that you should be able to write the documentation you need without giving up on any benefits and functionality of DITA.
In this course, you will learn:
Introduction &Installing the Tool for Writing - 10 min
How to get started writing in DITAXML. You will follow the steps to download and install one of the best DITAXMLeditors - Oxygen XMLAuthor.
DITAXMLElements - 45 min
Which are the DITAXMLmap elements that you would use frequently to organize the structure of your content? You will need:
mapref to reference one DITAXMLmap to another;
navref to switch the writing context between deliverables;
topicref to structure and organize your topics;
topichead to create a title to group together content underneath it.
This followed by a demo on how to use all these elements in an end-to-end scenario.
DITAXMLTopics and Topic Elements - 1 hour 25 min
DITAis a semantic language. It follows the principles of minimalism and structured topic-based writing.
You will understand the most frequently used DITAXMLtopic types:Task, Concept, and Reference.
I would dare to say that Task is the most important template for writing for a technical writer. It focuses on properly structuring and writing the content of each instruction you write.
You will see also specifics around more tricky DITAXML topic elements - such as the table and section elements, that help you better organize your documentation.
This all followed by a demo on how to use each of these elements.
You will perform short and straight-to-the-point exercises following the instructor's step-by-step demos.
What is not included in this course?
This is not a complete and exhaustive list of DITAXMLelements.
One of the most complicated aspects of DITAis related to the way-too-many elements that are available. In this course, we try to simplify it to help you get started quickly, instead of trying to cover every possible DITAaspect.
Try it out and up your DITAXML writing skills! Remember, technical writing is easy - after all, it is just plain docu!