Too often, when we work on a DITA implementation we spend a lot of time on the bells and whistles of our CMS or the DITA-OT publishing scripts. But, often the content is bloated, uses unsemantic markup, is riddled with duplication, and suffers from condition overload. If this is the case, you won’t get the […]
About Katriel Reichman
This author has yet to write their bio.Meanwhile lets just say that we are proud Katriel Reichman contributed a whooping 39 entries.
Entries by Katriel Reichman
Congratulations. You just got your brand new DITA specialization. And, you want to use it. Follow these instructions to successfully integrate your DITA Specialization to oXygen Editor or oXygen Author. These instructions apply when the DITA specialization is available as a DITA Open Toolkit plugin.
There are three possible containers for equations in the equation domain: equation-inline, equation-block, and equation-figure. Choose the DITA elements that makes the most sense for your equations: inline, in a separate block, and/or an equation or series of equation with a caption.
Writers are conditioned to using tables. We are creatures of habit, and using tables in DITA seems to come naturally if you are used to writing in Word or FrameMaker. Bottom line: When you need to present information that will be table-like when read, your default preference should be for definition lists. We know that you […]
Why use <choices> or <choicetables> instead of <ol> or <ul> in a task topic when you need to choose what to do next? DITA markup offers different options for describing choices in a DITA task topic. The benefit of <choices> or <choicetables> is that the markup is semantic! When you use <choices> or <choicetables>, the machine (and […]
Embedding multiple topics inside one topic file (polygamous topics) is not good practice. We call these topics, “polygamous topics”. If, in real life, polygamy tends to be a really bad idea, the same is true for DITA topics. The golden rule for DITA topics is
How you organize a bookmap will affect how easy or difficult it will be for you to maintain and update your content. Should you nest a DITA map under the <chapter> element in a bookmap, or should you nest topics directly under the <chapter> element?
What is Google Apps for Work? Google Apps is a cloud-based productivity suite that helps teams communicate, collaborate and get things done from anywhere and on any device. It’s simple to set up, use and manage, so your business can focus on what really matters. Who uses Google Apps for Work? Millions of organizations around the […]
For publications that have two or more very different kinds of information, use <part> in a DITA bookmap to divide a document’s chapters into logical groupings.
When you have a collection of DITA topics to nest, or individual DITA topics to next, you have a lot of choices. Often, too many choices. In a ditamap, you can nest DITA topics under a topic, <topichead> or <topicgroup>. In a bookmap, you can nest DITA topics or a ditamap under the <part> or […]
Great people at Method M
Great people at Method M deliver great results for our clients. Check out career opportunities at Method M.
Reach out to us on-line or on the phone
Building Success Everywhere
At Method M, we have clients and a history of success throughout the US and Canada, Great Britain, Switzerland, Australia, Israel and beyond. Looking forward to welcoming you to our roster of success!