too big bother


Aaron Mehl
 

Hi all,
I am just not sure how to author in Dita, large windows in the interface. The rule is for tasks to keep them short. This would mean breaking procedures into separate tasks. The problem I have is that I have some very busy windows in the interface I'm authoring and I would like to keep things in one place if at all possible. That said, I will give an example of a very busy window. I started adding call outs to the graphic, but stopped, since in my opinion it is just way to busy. 
The Dita task doesn't even come close to giving procedural steps for all the parts of the window. I want to K.I.S.S but I am not sure what to do. Maybe a table??
Any help/ideas would be most appreciated,
Aaron
 
So here is an example:
-----------------------------------------------------------------------
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<task id="payment_information">
  <title>Payment Information</title>
  <shortdesc>
    <draft-comment author="aaron">This has to be totally redone and then the graphic with call outs
      needs adding (scheduleNew.png)</draft-comment>
  </shortdesc>
  <taskbody>
    <context>To schedule a salary deposit transaction:</context>
    <steps>
      <step>
        <cmd>Click on <uicontrol>Deposit</uicontrol> in the <uicontrol>Payment
            information</uicontrol> slider. </cmd>
      </step>
      <step>
        <cmd>Choose <term>Direct Deposit </term>as the payment method, from the drop down
          list. </cmd>
        <substeps id="substeps_yv4_nm3_d4b">
          <substep>
            <cmd>In the <uicontrol>Account</uicontrol> combo box, choose the account to deposit your
              salary in.</cmd>
          </substep>
          <substep>
            <cmd>From the <uicontrol>Pay to/from</uicontrol> drop down list choose
                <uicontrol>From</uicontrol>, if it isn't already selected.</cmd>
          </substep>
          <substep>
            <cmd>Type <term>Job</term> in the <uicontrol>payto/from name</uicontrol>field.</cmd>
            <info>If job is already listed, go to the <uicontrol>category</uicontrol> combo box,
              otherwise:</info>
          </substep>
          <substep>
            <cmd> A dialog box opens asking if you want to add this
              payee/receiver.</cmd>
          </substep>
          <substep>
            <cmd> Click <term>Yes</term>.</cmd>
            <stepresult>The new payee job is added to list of payees.</stepresult>
          </substep>
        </substeps>
      </step>
      <step>
        <cmd>Choose <term>Salary</term> in <uicontrol>Category</uicontrol> list.</cmd>
      </step>
      
      <step>
        <cmd>Enter the date you get paid in <uicontrol>Next due date</uicontrol> field, either: </cmd>
        <choices>
          <choice>Type the date.</choice>
          <choice>Use the up and down arrows to select the date.</choice>
          <choice>Click on the calendar icon and select the date.</choice>
        </choices>
      </step>
      <step>
        <cmd>Enter the amount you get paid in the <uicontrol>Amount</uicontrol> field, either:</cmd>
        <choices>
          <choice>Type in the amount</choice>
          <choice>Click on the calculator icon and enter the amount. </choice>
        </choices>
      </step>
    </steps>
  </taskbody>
</task>
----------------------------------------------------
Then here is the graphic as an attachment:
  

Join main@dita-users.groups.io to automatically receive all group messages.