[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: RE: [dita] Another request for steps-informal example
Here's how I would explain it: The <steps-informal> element can be used in the place of either <steps> or <steps-unordered> to document the actions that the reader should perform in a task. For example, six actions that the reader must perform in a particular sequence could be marked up as follows: <steps> <step><cmd>Remove the old oil filter.</cmd></step> <step><cmd>Drain the old oil.</cmd></step> <step><cmd>Install a new oil filter and gasket.</cmd></step> <step><cmd>Add new oil to the engine.</cmd></step> <step><cmd>Check the air filter and replace or clean it.</cmd></step> <step><cmd>Top up the windshield washer fluid.</cmd></step> </steps> Using the <steps-informal> element, the same actions can be documented as follows: <steps-informal> <ol> <li>Remove the old oil filter.</li> <li>Drain the old oil. </li> <li>Install a new oil filter and gasket. </li> <li>Add new oil to the engine.</li> <li>Check the air filter and replace or clean it.</li> <li>Top up the windshield washer fluid.</li> </ol> </steps-informal> The advantage of using <steps-informal> with <ol>, instead of <steps>, is that compared to <steps>, the <ol> content model is simpler. It also has more similarities to HTML, making document conversion from HTML easier. Su-Laine -----Original Message----- From: Robert D Anderson [mailto:robander@us.ibm.com] Sent: Monday, February 02, 2009 11:23 AM To: dita Subject: [dita] Another request for steps-informal example Hello everybody, Early drafts of DITA 1.2 added a <process> element to task for describing procedural task information that does not fit into <steps>. I asked a couple of times for an example to include in the language specification, but didn't get one. Late last year we changed the name from <process> to <steps-informal>, but I still don't have an example. Can anybody on the list provide an example for the <steps-informal> element? The original proposal does not explain the element beyond what I've stated above, and does not give an example. I know a number of people on the TC feel this element is critical, so I would appreciate it if one of those people can provide an example to include in the Language Specification... Thanks, Robert D Anderson IBM Authoring Tools Development Chief Architect, DITA Open Toolkit --------------------------------------------------------------------- To unsubscribe from this mail list, you must leave the OASIS TC that generates this mail. Follow this link to all your TCs in OASIS at: https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]