flowcharting dita
TRANSCRIPT
FLOWCHARTING DITA
JANG F.M. GRAAT
WHO’S TALKING ?• Jang F.M. Graat
• Amsterdam, NL
• Psychology, Philosophy
• 25+ years Tech Comms
• 5+ years DITA
• XML, XSLT, JS, PHP, etc.
• Geek Philosopher
WHAT IS THE PROBLEM ?
OPTIONAL PROCEDURE STEPS
1. Unscrew and remove the oil inlet cap 2. Check the current oil level
a) Clean the oil gauge b) Insert the oil gauge as far as it goes c) Remove the oil gauge d) Check the oil level on the gauge
3. If the level is below the minimum (A) a) Add some fresh oil (see specs) b) Repeat step 2)
4. Place and tighten the oil inlet cap
A
BRANCHING PROCEDURES
Oil Level Cold Check !Perform engine oil level COLD CHECK as follows: 1 For pre-ride inspection with the vehicle on jiffy stand on level ground, remove and wipe off the dipstick. Install the dipstick
back into the oil tank. NOTE: For FXCWC models, thread the filler cap onto the spout until tight. On all other models, push the filler cap until fully seated
in the spout.! 2 See Engine Oil Level: Softail Models (Typical). Remove the dipstick and verify oil registers on the dipstick between the
two marks. ! a If oil level registers on the dipstick, proceed to Oil Level Hot Check. b If oil does not register on the dipstick, proceed to step 3. ! 3 With the dipstick removed, look into the dipstick opening and verify the oil level is at the filler neck weld. ! a If the oil level is at or near the filler neck weld, proceed to Oil Level Hot Check. b If the oil level is not at or near the filler neck weld, add only enough oil to bring the level to the filler neck weld. Then
proceed to Oil Level Hot Check. !!
BRANCHING PROCEDURES
Oil Level Cold Check !Perform engine oil level COLD CHECK as follows: 1 For pre-ride inspection with the vehicle on jiffy stand on level ground, remove and wipe off the dipstick. Install the dipstick
back into the oil tank. NOTE: For FXCWC models, thread the filler cap onto the spout until tight. On all other models, push the filler cap until fully seated
in the spout.! 2 See Engine Oil Level: Softail Models (Typical). Remove the dipstick and verify oil registers on the dipstick between the
two marks. ! a If oil level registers on the dipstick, proceed to Oil Level Hot Check. b If oil does not register on the dipstick, proceed to step 3. ! 3 With the dipstick removed, look into the dipstick opening and verify the oil level is at the filler neck weld. ! a If the oil level is at or near the filler neck weld, proceed to Oil Level Hot Check. b If the oil level is not at or near the filler neck weld, add only enough oil to bring the level to the filler neck weld. Then
proceed to Oil Level Hot Check. !!
Oil Level Hot Check !Perform engine oil level HOT CHECK as follows: ! 1 Ride motorcycle until engine is at normal operating temperature. NOTE: The engine will require a longer warm up period in colder weather. ! 2 With the vehicle upright on level ground, allow engine to idle for 1-2 minutes. Turn engine off. 3 With vehicle on jiffy stand remove and wipe off the dipstick. Install the dipstick back into the oil tank. ! NOTE: ! For FXCWC models, thread the filler cap onto the spout until tight. On all other models, push the filler cap until fully seated
in the spout.! 4 See Engine Oil Level: Softail Models (Typical). Remove the dipstick and note the level of the oil. Add only enough oil to
bring the level to the FULL mark on the dipstick. Do not overfill. NOTE: ! Refer to Recommended Engine Oils. Use only recommended oil specified under Engine Lubrication. ! 5 Start engine and carefully check for oil leaks around drain plug and oil filter.
TROUBLESHOOTING
THIS CAN GET COMPLICATED
NOT A GOOD SOLUTION
CONTEXT DEPENDENCIES
WHY NOT USE REAL
(VS. MENTAL)
FLOWCHARTS ?
NOT A SPECIALIZATION
CREATING FLOWCHARTS
BASIC NODES
• Start
• Process (including inputs)
• Decision
• Yes/No
• Multiple choices
• End
START = CONTEXT / PREREQ
<context> <p>Checking the oil level will prevent serious damage and does not require tools.</p></context>
PROCESS = STEP (+ INFO ETC.)
<step> <cmd>Remove the oil inlet cap</cmd> <info>The oil inlet cap is on the bottom right side of the engine.</info></step>
DECISION = STEP + CHOICES
<step><cmd>Which model ?</cmd>
<choices> <choice>Softail</choice>
<choice>FSCWC</choice></choices>
</step>
END = POSTREQ
<postreq> <p>Check the oil level again after riding the next 100 miles.</p></postreq>
TRANSFORM TO DITA
<task id="task_zph_dnq_vp"> <title>Replacing the oil</title> <taskbody> <context> <p>Checking the oil level will prevent serious "" damage and does not require tools.</p> </context> <steps> <step id="step1"> <cmd>Remove the oil inlet cap</cmd> <info>The oil inlet cap is on the bottom "" right side of the engine.</info> </step> <step id="step2"> <cmd>Remove dipstick and wipe it clean.</cmd> </step> <step id="step3"> <cmd>What is the bike model?</cmd> <choicetable> <chrow> <choption>Softail</choption> <chdesc>Continue with step 4</chdesc> </chrow> <chrow> <choption>FSCWC</choption> <chdesc>Continue with step 5</chdesc> </chrow> </choicetable> </step>"" …
INTERACTIVE MEDIA
NESTING TASKS IN STEPS
NO MORE TROUBLE TABLES
NO MORE ANCIENT METHODS
DRIVING DITA OFF THE MAP
