Interface Insight
You are documenting a new software update. There is a giant blue button that says "Deploy Now." How should the text "Deploy Now" be tagged?
What is <uicontrol>?
A writer is documenting how to save a file. They have the instructions written out but realize they forgot to tell the user they need to be logged in as an Admin first. Which element should hold this "logged in as Admin" requirement?
What is <prereq>?
A writer wants to add a small "pro-tip" that isn't essential for the task but will save the user time. What is the basic tag used to set this information apart from the main text?
What is <note>?
In a "Reference" topic, you are listing the priority levels for support tickets (1. Critical, 2. High, 3. Low). The numbers are important because they show the order of importance. What element automatically generates a numbered list for these items?
What is <ol>?
You are writing a "Concept" topic and need to start a new block of text to describe a feature. What is the most common block-level element used to wrap a single paragraph of text?
What is <p>?
The user needs to navigate through Tools, then Options, then Global Settings. What "parent" element should wrap these three <uicontrol> tags to show the path?
What is <menucascade>?
A software step is very complex. After the user clicks "Submit," a green checkmark appears to let them know it worked. The writer wants to capture this specific moment. What element is used to describe this "green checkmark" confirmation?
What is <stepresult>?
A writer is documenting a step where a user could accidentally delete their data if they aren't careful. This is a serious "heads up." On the <note> tag, which type attribute should be used to change the icon?
What is type="caution"?
Within your Definition List, you are ready to create your first entry for the term "Metadata." What is the "wrapper" element that must hold both the term and its corresponding definition together as a single unit?
What is <dlentry>?
You want to include a diagram of a motherboard in your documentation. You have the file motherboard.png saved in your images folder. What element is used to reference and display this graphic file in your DITA topic?
What is <image>?
A popup appears. The very top bar of the popup says "Error Code 404: File Not Found." Which tag identifies this specific text from the top of the window?
What is <wintitle>?
A writer is documenting how to reset a password. They have a list of five sequential actions the user must perform. What is the primary element that must wrap these five individual actions?
What is <steps>?
A writer is documenting a complex software setup. They want to include a helpful tip that mentions a keyboard shortcut, which isn't a required step but would make the user's life easier. What is the base element used to offset this type of supplementary information from the main body text?
What is <note>?
You are documenting a list of ingredients. Your company style guide says lists with more than 10 items should be alphabetized but not numbered. Which tag should you use to ensure the output shows bullets instead of numbers?
What is <ul>?
You are adding a photo of a button, and you want to ensure that if a visually impaired user is using a screen reader, the device will describe the image to them. Which element, nested inside <image>, is used to provide this?
What is <alt>?
The documentation says: "In the 'Hostname' field, type prod-server-01." How should the writer tag the specific text prod-server-01?
What is <userinput>?
The procedure is over. The writer wants to add a sentence that says, "Your account is now active and you can begin uploading files." What element should be used to tag this sentence?
What is <result>?
A writer wants to include a helpful piece of advice that isn't required for the task but adds extra value—like a keyboard shortcut that makes a process faster. They look for a <tip> tag in their XML editor but can't find one. How does a writer correctly create a "Tip" in DITA if there is no specific <tip> element?
What is a <note> with the attribute type="tip"?
You have a standard "Safety Warning" that needs to appear in 50 different manuals. Instead of typing it 50 times, you want to write it once in a central file and "pull" it into the other topics.What is the name of the attribute used to create this "live link" between elements?
What is conref?
You want an icon (like a "Save" diskette) to appear right in the middle of a sentence, like this: "Click the [icon] to continue." To make the image appear on the same line as the text rather than on a new line, you must set the placement attribute to what value?
What is placement="inline"?
A user enters their username, and the software displays a message that says "Login Successful." Since the computer generated this text in response to the user, how should "Login Successful" be tagged?
What is <systemoutput>?
A writer wants to add something the user must do after the task is done, like turning off the machine. What is the specific tag for these "after-task" instructions?
What is <postreq>?
A writer is documenting a new software feature that is legally required to include a specific disclaimer. This isn't a warning about a mistake, but a formal announcement of a policy or a legal requirement. Which type attribute on the <note> element should be selected?
What is type="notice"?
You are trying to conref a paragraph from a shared file, but your XML editor says it’s invalid. You realize the paragraph you are trying to pull doesn't have a unique "name" assigned to it in the source file. In order for an element to be "pullable" via conref, what attribute must be present on the source element?
What is an id?
You are writing a "Concept" topic and want to mention that the information was gathered from a manual titled The DITA 1.3 Specification Guide. What element should you wrap around the title of the manual to identify it as a citation?
What is <cite>?