Archive

New User

Hello, I am new to DITA, well I have worked as a technical writer and is equally passionate to continue; I would like to know how to use DITA; as I have been using WORD to prepare SDLC documents, so to enhance myself more in this profession I am eager to learn how to implement DITA or if I simply say that I want to make a vision document than how DITA will be used. Warm Regards, Omer

DITA and wiki hybrids - they’re here

Lisa Dyer and Alan Porter presented at last week’s DITA Central Texas User Group meeting, and both told tales of end-user doc written and sourced in DITA, with wikitext in mind as an output. About 20 people attended and we all enjoyed the show. I wanted to post my notes to follow up, and I’ll post a link to slide shows as well.

This post covers Lisa Dyer’s presentation on a wiki sourced with DITA topics. I’ll write another post to cover Alan’s presentation.

Read more

Short Descriptions for Tasks

What is a good short description for a task?

Some of the short descriptions indicated as "good" in the class assignments simply restated information that was in the short description of the related concept. The task's short description may have been written differently and in the imperative, but it was redundant information.

Read more

Self on Help

"Airplane Help"

"Airplane Help" describes a technique whereby locally installed Help and server-based Help are integrated, so that a software application user is presented with server Help if he or she has an Internet connection, or local Help if not. The advantage of this approach is that the most current version of the Help is displayed if possible, but at least some form of Help is displayed when the user is "offline". Can DITA play a role in delivering Airplane Help?

Read more

UCSC DITA XML Intro course - assignment 2 - results with comments

Assignment 2: DITA authoring

Materials:

  • Review the presentation at http://www.ditausers.org/tutorials/basics/Priestley_Authoring/
  • Read section 3.1 of the DITA 1.1 architectural specification:
    http://docs.oasis-open.org/dita/v1.1/CS01/archspec/archspec.html
  • Read the description of <shortdesc> in the DITA 1.1 language specification:
    http://docs.oasis-open.org/dita/v1.1/CS01/langspec/langref/shortdesc.html

Assignment:

Read more

XML.org Focus Areas: BPEL | DITA | ebXML | IDtrust | OpenDocument | SAML | UBL | UDDI
OASIS sites: OASIS | Cover Pages | XML.org | AMQP | CGM Open | eGov | Emergency | IDtrust | LegalXML | Open CSA | OSLC | WS-I