Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.

Flowcharting DITA

1,244 views

Published on

This short presentation shows how a homegrown flowchart editor, running in a web browser, can be used to design DITA tasks. Instead of painstakingly editing the steps and choice tables, linking them by cross-references, just draw a flowchart and connect its building blocks. Let the software transform your design into a valid and correct DITA task. Of course, you can also skip the DITA and go for interactive HTML5 plus JavaScript.

Published in: Technology
  • Be the first to comment

Flowcharting DITA

  1. 1. FLOWCHARTING DITA JANG F.M. GRAAT
  2. 2. 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
  3. 3. WHAT IS THE PROBLEM ?
  4. 4. 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 OPTIONAL PROCEDURE STEPS
  5. 5. 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. BRANCHING PROCEDURES ! 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. !!
  6. 6. Oil Level Cold Check COLD CHECK as follows: 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 !! 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.
  7. 7. TROUBLESHOOTING
  8. 8. THIS CAN GET COMPLICATED
  9. 9. NOT A GOOD SOLUTION
  10. 10. CONTEXT DEPENDENCIES
  11. 11. WHY NOT USE REAL (VS. MENTAL) FLOWCHARTS ?
  12. 12. NOT A SPECIALIZATION
  13. 13. CREATING FLOWCHARTS
  14. 14. BASIC NODES • Start • Process (including inputs) • Decision • Yes/No • Multiple choices • End
  15. 15. <context> <p>Checking the oil level will prevent serious damage and does not require tools.</p> </context> START = CONTEXT / PREREQ
  16. 16. <step> <cmd>Remove the oil inlet cap</cmd> <info>The oil inlet cap is on the bottom right side of the engine.</info> </step> PROCESS = STEP (+ INFO ETC.)
  17. 17. <step> <cmd>Which model ?</cmd> <choices> <choice>Softail</choice> <choice>FSCWC</choice> </choices> </step> DECISION = STEP + CHOICES
  18. 18. <postreq> <p>Check the oil level again after riding the next 100 miles.</p> </postreq> END = POSTREQ
  19. 19. <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>" " … TRANSFORM TO DITA
  20. 20. INTERACTIVE MEDIA
  21. 21. NESTING TASKS IN STEPS
  22. 22. NO MORE TROUBLE TABLES
  23. 23. NO MORE ANCIENT METHODS
  24. 24. DRIVING DITA OFF THE MAP
  25. 25. QUESTIONS ? • @4everJang • jang@jang.nl • www.ditadocs.com • www.writeless.eu • www.jang.nl

×