• Skip to primary navigation
  • Skip to main content
  • Skip to primary sidebar

Learning DITA

Free DITA training

Free DITA training

  • Log in
  • Register
  • Newsletter
  • Profile
  • Privacy
  • Home
  • About
  • Courses
  • News
  • Resources
  • Support the site
  • Contact
  • Recordings

Best practices for conditions

Posted on 12.02.16

Advanced reuse in DITA Lesson 1: Using conditions Best practices for conditions
Lesson Progress
0% Complete

 

Do not filter sentence fragments

As described in the basic course on reusing elements, do not use filtering on anything smaller than a sentence.

It’s better to have two instances of an entire sentence that are grammatically correct (and will remain correct when translated) than to risk ending up with poorly constructed—or even non-sensical—sentences.

Communicate your choices

Create a style guide or some other form of documentation so that everyone on your team, organization, or company uses conditional attributes and values consistently.

Make sure you have agreement on:

  • How and why everyone uses the audience, platform, product, and otherprops attributes.
  • The precise values everyone uses with those attributes and the meaning of each value. Remember that case matters when comparing attribute values with the val attribute in ditaval file.

Consider specialization

If there are not enough conditional attributes for your needs, or if the names of the attributes do not fit with how you are using them, consider using the DITA specialization mechanisms to create additional conditional attributes.

Contributors
  • Simon Bate
  • Jake Campbell
  • Gretyl Kinsey
Previous Topic
Back to Lesson
Next Lesson

sidebar

Blog Sidebar

  • Scriptorium logo
    Maximize the value of your content. Read more.
  • Scriptorium logo
    Need DITA help? We offer flat-rate consulting. Get help.
  • Scriptorium logo
    Already in DITA and need support? Contact us.
RSSTwitter

Want to add content? Join the ditatraining GitHub repository.

  • Home
  • Sponsor
  • News
  • Contact
  • Privacy

Maintained by Scriptorium Publishing

Logo and site presentation © 2015-2021 Scriptorium Publishing. Content based on the open-source DITA training project.