20 minutes | Feb 24th 2020

LearningDITA Live 2020 highlights (podcast)

In episode 70 of The Content Strategy Experts Podcast, Elizabeth Patterson shares some highlights from LearningDITA Live 2020. “Structured content is a way to strategically optimize your content so it frees your content from the format. Because it’s free of the format, it also frees it from tools.” —Bernard Aschwanden Related links: LearningDITA Live 2020 recordings  Twitter handles: @PattersonScript @simonbate @aschwanden4stc @easyDITA @OctavianNadolu @cwhandrews @gretylkinsey @Center4infoDev @kheathScript @Turbonomic @cdybdahl @JackMolisani Transcript: Elizabeth Patterson:     Welcome to The Content Strategy Experts Podcast brought to you by Scriptorium. Since 1997 Scriptorium has helped companies manage, structure, organize and distribute content in an efficient way. In episode 70 we take a look at some of the highlights from LearningDITA Live 2020. Hi, I’m Elizabeth Patterson and today I’m going to share with you some bits and pieces from the sessions from LearningDITA Live 2020. We’re going to start with a highlight from Simon Bate of Scriptorium. Simon’s session was Introduction to DITA. In this clip, Simon talks about some of the reasons you might want to use DITA and some of the benefits it offers. Simon Bate:     Let’s talk about some of the reasons you might want to use DITA and some of the benefits it offers. Being an open standard makes DITA flexible. DITA can be used with a variety of different tools for authoring, editing, formatting, and storing content. If your business goals change or your context view change being in DITA makes it easier to go to a different toolset while keeping the same source content. The elements used to mark up your DITA content, give your content semantic value. That is every piece of content in DITA is tagged with an element. Semantic value means that the tag surrounding each piece of content has meaning such as paragraph, step, hazard statement and so on. Both your authors and your authoring and publishing tools know what kind of information is contained in each tag. Tagging your content that has semantic value also helps with search and filtering. SB:     Topic-based content is easier to reuse. Individual topics can be used and reused in any order in any number of different documents. In DITA the topics are organized in maps which are much like a table of contents. The map allows you to specify the order and hierarchy of your topics. A reusable topic addresses a single idea or question. It contains enough information to stand on its own and it doesn’t assume any context about what information comes before it or after it. And separating your content for the formatting makes it easy to produce multiple outputs. If you’re producing more than one type of output. For example, PDF, HTML and EPUB using DITA allows you to apply different formatting to the same set of source files, which means all your outputs will be consistent with each other. EP:     This session was particularly beneficial for those that were relatively new to DITA so if you’re interested in watching this recording or you missed it, you can find the link to the complete recordings in the show notes. In this next highlight Bernard Aschwanden from Publishing Smarter presented 10 ways DITA can help drive a unified content strategy. In the following clip he talks to us about what a unified content strategy is. Bernard Aschwanden:     A unified content strategy is really that methodical and purposeful management of information assets across all of the divisions of your enterprise. This really has to be done in a way that breaks down the silos and makes that information easy to find and easy to use. Structured content is really best as a way to strategically optimize your content so it frees your content from the format and because it’s free of the format, it also frees it from tools. Like for example Microsoft word. There is no proprietary format that you have to think about. In turn this then enables intelligent reuse, multichannel publishing, efficiencies in the translation and all sorts of enhancements when you’re delivering content to your end users. BA:     A structure also gives you a markup for the content and it does so through this semantic set of elements and metadata that in turn can lead to high levels of consistency and help lower maintenance efforts. Structured content really is fully ready for XML and not behind the scenes XML is what gives structured content all of its so-called superpowers. There is an XML standard that’s really taken off in TechComm and that’s DITA. And I would say one thing that TechComm communicators know inside and out is content. Whether it’s the planning, the creation, the review, or the delivery, we are the experts in the room. It’s probably safe to say that we’re the experts inside the enterprise. EP:     Jarod Sickler of Jorsek presented DITA CCMS. What is it? Why do you need one? How to pick the right one. In this next clip, Jarod explains what a DITA CCMS is. Jarod Sickler:     This is an important point. DITA CCMS is a CCMS that’s specifically designed to handle all aspects of DITA content and its semantic markup. They’re designed to effectively manage those components both as independent resources. If you think of a particular phrase or a word, a CCMS is designed to manage those components as individual resources. Phrases, but also when that phrase is used as part of a larger content object. A CCMS has to simultaneously manage it independently and as a part. EP:     If you are considering a DITA CCMS, this presentation would be really beneficial for you. Jarod goes into a lot more detail in the presentation about what your CCMS should offer, so be sure to check for the link to the recordings. Next we’re going to hear an excerpt from Octavian Nadolu of Synchro Soft. He presented custom business rules for DITA projects. In this clip he gives some examples of specific business rules that he uses in a particular project. Octavian Nadolu:     For DITA I added a few businesses that we have, for example in our documentation project such as titles must be uppercase. I want in my DITA project to have all the titles uppercase and I can add these type of rule or short description should not exceed 50 characters otherwise it is not a short description anymore or I want to avoid empty elements in my project or I want to avoid semi-colon at the end of our list items. You either add a dot or you don’t add any semi-colon then a list should have more than one list item otherwise what where you should have a list or, and another rule would be to have output classes on code blocks. Otherwise, the output would not look as you want when it’s published. EP:     Charlie Andrews from Ovitas presented centralized metadata management simplifies DITA implementation. In this next clip Charlie explains what metadata is. Charlie Andrews:     What is metadata? Metadata describes and categorizes content as information about information and how that content lives and how it relates to your organization, your products, customers, and then how it may be used within a component content management system to manage your content. And we’ll talk about that a little bit. I think what’s important to this particular bullet item is that it’s your organization, not just products and not just content, but metadata describes a lot of things even outside the content management system. You can have taxonomies that describe your corporate relations of all of your products or all of your marketing and all of your sales and all of the different areas of support and things like that. All of those things are metadata and can be gathered together in support of the types of things that you’re trying to publish, right. The major categories of metadata pretty much are agreed there’d be three different categories, descriptive, structural and administrative metadata. Charlie Andrews:     For those of you not familiar with this descriptive metadata is the things you would normally think of who wrote something, what’s it’s title, what’s the date it was done? What product, family or model or part number or things like that. It describes the particular piece of content that you’re looking to do. Structural metadata it basically talks about the relationship between different, DITA content, topics or chunks and how they should be assembled or packaged. A structural metadata may be used in DITA maps and things like that. Administrative metadata may include things like geo-market or location. What version, what files, what rights management, what permissions does a piece of information have? EP:      Gretyl Kinsey of Scriptorium presented Unsung heroes of DITA. In this highlight, she talks about what the powers of relationship tables are. Gretyl Kinsey:     Here are the rel tables powers. Rel tables establish relationships among content such as specifying how DITA topics and a map relate to one another. Defining associations among DITA topics and non-DITA resources and the most common use of rel tables is giving you the structure that you need to generate a list of related links in your output. We’ve seen a lot of companies set up links among topics using embedded inline cross-references in DITA, and while that is a valid way to set up your linking in DITA, there are issues around reuse for that approach, which we’re going to get into in a little bit more detail later on. GK:     There are also some issues around link management with inline cross-references. Basically the more inline links that you have, the more difficult it can be to keep track of them all and manage them all, especially when you do have a lot of reuse. But rel tables give you a way to create a network of links among rel
Play Next