This discussion has been locked.
You can no longer post new replies to this discussion. If you have a question you can start a new discussion

Not For the SQEM-ish

This is a "Quick-n-Dirty" SQEM (Software Quality Engineering Manual) flow chart:
(NOTE: Most "software engineers" only bother with the 'red' portions)

               Software Quality Engineering Manual Flow Chart

                           .----------------.
                           |  System Spec.  |
                           |     (EICD)     |  (Electrical Interface Control Drawing)
                           '----------------'
                                   |
                                   V
 .--------------.          .----------------.                  .----------------.
 |   Schedule   |          | Software Dev.  |                  | System Req.    |
 | (Gantt Chart)|<---------| Plan (SDP)     |----------------->| Analysis (SRA) |
 '--------------'          '----------------'                  '----------------'
         |                         |                                    |
         V                         V                                    V
 .--------------.          .------------------.                .----------------.
 |  Resources   |          | Software Product |<---------------| System Design  |
 |(People/Equip)|          | Specification    |                | Document (SSDD)|
 '--------------'          |      (SPP)       |>--------.      '----------------'
                           '------------------'         |        |      |
                                   |              .-----|--------'      |
                                   V              |     |               V
                           .------------------.   |     |      .-----------------.
                           | Interface Req.   |--------------->| Hardware Config |
                           | Specification    |   |  .---------| Interface (HWCI)|>----.
                           |     (IRS)        |   |  |  |      '-----------------'     |
                           '------------------'   |  |  |                              |
                                   |              |  |  |                              |
 .--------------.                  V              |  |  |                              |
 | Comp Systems |          .------------------.   |  |  |      .------------------.    |
 |  Op Manual   |<---------| Interface Design |<-----'  |      | Computer Resource|    |
 |    (CSCM)    |    |     | Document (IDD)   |   |  .---------| Integration and  |    |
 '--------------'    |     '------------------'   |  |  |      | Integration Doc  |    |
                     |             |              |  |  |      |     (CRISD)      |    |
                     |             |              |  |  |      '------------------'    |
                     |             |              |  |  |                              |
                     |             V              |  |  |                              |
 .--------------.    |     .------------------.   |  |  |      .------------------.    |
 | Software User|<---'     |  Software Req.   |<--'  |  '----->|     Use Case     |    |
 |   Manual     |          |  Specification   |<-----'         |     Document     |    |
 |    (SUM)     |<---------|       (SRS)      |<---------------|       (UCD)      |    |
 '--------------'    |     '------------------'                '------------------'    |
                     |             |           \                        |              |
                     |             V            \                       V              |
 .--------------.    |     .------------------.  \             .------------------.    |
 |  Software    |    |     |  Software Design |   '----------->|    System Test   |    |
 |  Program     |<---' .---|  Document(s)     |--------------->|    Description   |    |
 |  Manual (SPM)|      |   |      (SDDs)      |   .----------->|       (STD)      |<---'
 '--------------'      |   '------------------'   |           /'------------------'
                       |           |              |          /          |
                       |           V              |         /           V
 .--------------.      |   .------------------.   |        /   .------------------.
 |  Data Item   |<-----'   | Computer Software|   |       /    |      Software    |
 |  Description |          | Components/Units |---'      /     |  Test Proceure   |----.
 |     (DID)    |<-------->|    CSCs & CSUs   |         /      |        (STP)     |    |
 '--------------'          '------------------'        /       '------------------'    |
                                   |                  /                                |
                                   V                 /                                 |
 .--------------.          .------------------.     /          .------------------.    |
 |  "Software"  |<---------| Software Coding  |>---'           | Coding Guidelines|    |
 |    (CSCI)    |          |  "Code Monkeys"  |<---------------| "Rule Book for   |    |
 |  Executable  |------.   '------------------'                |   Code-Monkeys   |    |
 '--------------'      |           |                           |    (CGRBFCM)     |    |
       /|\             |           |                           '------------------'    |
        |              |           V                                                   |
        |              |   .----------------------.                                    |
        |              |   | Formal Qualification |<-----------------------------------'
        |              |   |  Testing (FQT))      |                                    |
        |              |   '----------------------'                                    |
        |              |           |                                                   |
        |              |           |                                                   |
       \|/             |           V                                                   |
 .--------------.      |   .-------------------.               .------------------.    |
 |  Firmware    |      |   |Version Description|               |  Software Test   |<---'
 |  Support     |      |   |  Document (VDD)   |<--------------| Report (STR)or   |
 |  Manual (FSM)|      |   '-------------------'               '------------------'
 '--------------'      |
                       |
                       |
                       |   .------------------.
                       '-->| Release to the   |
                           |     Customer     |
                           '------------------'

(NOTE: ASCII art isn't fun)

The above is an iterative process.

--Cpt. Vince Foster
2nd Cannon Place
Fort Marcy Park, VA

Parents
  •      |               |             V            \                       V              |
     .--------------.    |     .------------------.  \             .------------------.    |
     |  Software    |    |     |  Software Design |   '----------->|    System Test   |    |
     |  Program     |<---' .---|  Document(s)     |--------------->|    Description   |    |
     |  Manual (SPM)|      |   |      (SDDs)      |   .----------->|       (STD)      |<---'
     |Skip this one |      |   |Written as the    |   |            |AKA Tell Dave the |
     |management    |      |   |overall module    |   |            |test guy that new |
     |says we alreay|      |   |comments that     |   |            |firmware is almost|
     |have too many |      |   |apear at the top  |   |            |ready. Give him   |
     |manuals       |      |   |of each filethat  |   |            |the stickey note  |
     |              |      |   |makes up the code |   |            |from screen and   |
     '--------------'      |   |for the project   |   |            |tell him to test  |
                           |   |                  |   |            |for "this stuf"   |
                           |   '------------------'   |     -------'------------------'
                           |           |              |     |                |
                           |           V              |     |                V
     .--------------.      |   .------------------.   |     |      .------------------.
     |  Data Item   |<-----'   | Computer Software|   |     |      |      Software    |
     |  Description |          | Components/Units |---'     |      |  Test Proceure   |----.
     |AKA Use       |          | Written as       |         |      | Use black box    |    |
     |descriptive   |          | comment above    |         |      | testing as to    |    |
     |vaiable names |          | each function    |         |      | not waste time   |    |
     |              |<-------->|    CSCs & CSUs   |         |      | showing Dave how |    |
     '--------------'          '------------------'         |      | things actually  |    |
                                       |                    |      | work.            |    |
                                       |                    |      '------------------'    |
                                       |                    |                              |
                                       |                    |                              |
                                       V                    |                              |
     .--------------.          .------------------.         |      .------------------.    |
     |  "Software"  |<---------| Software Coding  |>--------'      | Coding Guidelines|    |
     |    (CSCI)    |          |  "Code Monkeys"  |<---------------| "Rule Book for   |    |
     | Outputed     |          | Spend %90 project|                |   Code-Monkeys   |    |
     | by compiler  |          | work here as it  |                |      AKA         |    |
     | unless there |          | is very important|                |     ALWAYS       |    |
     | are syntax   |          | and screens are  |                |     Follow       |    |
     | errors avoid |          | too few and too  |                |   Cpt Vince's    |    |
     | these at all |          | small            |                |     advice.      |    |
     | costs.       |------.   '------------------'                |    (CGRBFCM)     |    |
     '--------------'      |           |                           '------------------'    |
           /|\             |           |                                                   |
            |              |           V                                                   |
            |              |   .----------------------.                                    |
            |              |   | Formal Qualification |<-----------------------------------'
            |              |   |  Testing (FQT))      |                                    |
            |              |   | Dave does the actual |                                    |
                               | testing.             |                                    |
            |              |   '----------------------'                                    |
            |              |           |                                                   |
            |              |           |                                                   |
           \|/             |           V                                                   |
     .--------------.      |   .-------------------.               .------------------.    |
     |  Firmware    |      |   |Version Description|               |  Software Test   |<---'
     |  Support     |      |   |  Document (VDD)   |<--------------| Report (STR)     |
     |  Manual (FSM)|      |   |Make sure to update|               | Dave gives the   |
     |Dont even     |      |   |version number in  |               | thumbs up.       |
     |bother asking |      |   |code or you might  |               '------------------'
     |as we are way |      |   |think you have the |
     |behind our    |      |   |wrong version.     |
     |original ASAP |      |   '-------------------'
     |plan.         |      |
     '--------------'      |
                           |
                           |
                           |   .------------------.
                           '-->| Release to the   |
                               |     Customer     |
                               '------------------'
    
    

    2nd half

Reply
  •      |               |             V            \                       V              |
     .--------------.    |     .------------------.  \             .------------------.    |
     |  Software    |    |     |  Software Design |   '----------->|    System Test   |    |
     |  Program     |<---' .---|  Document(s)     |--------------->|    Description   |    |
     |  Manual (SPM)|      |   |      (SDDs)      |   .----------->|       (STD)      |<---'
     |Skip this one |      |   |Written as the    |   |            |AKA Tell Dave the |
     |management    |      |   |overall module    |   |            |test guy that new |
     |says we alreay|      |   |comments that     |   |            |firmware is almost|
     |have too many |      |   |apear at the top  |   |            |ready. Give him   |
     |manuals       |      |   |of each filethat  |   |            |the stickey note  |
     |              |      |   |makes up the code |   |            |from screen and   |
     '--------------'      |   |for the project   |   |            |tell him to test  |
                           |   |                  |   |            |for "this stuf"   |
                           |   '------------------'   |     -------'------------------'
                           |           |              |     |                |
                           |           V              |     |                V
     .--------------.      |   .------------------.   |     |      .------------------.
     |  Data Item   |<-----'   | Computer Software|   |     |      |      Software    |
     |  Description |          | Components/Units |---'     |      |  Test Proceure   |----.
     |AKA Use       |          | Written as       |         |      | Use black box    |    |
     |descriptive   |          | comment above    |         |      | testing as to    |    |
     |vaiable names |          | each function    |         |      | not waste time   |    |
     |              |<-------->|    CSCs & CSUs   |         |      | showing Dave how |    |
     '--------------'          '------------------'         |      | things actually  |    |
                                       |                    |      | work.            |    |
                                       |                    |      '------------------'    |
                                       |                    |                              |
                                       |                    |                              |
                                       V                    |                              |
     .--------------.          .------------------.         |      .------------------.    |
     |  "Software"  |<---------| Software Coding  |>--------'      | Coding Guidelines|    |
     |    (CSCI)    |          |  "Code Monkeys"  |<---------------| "Rule Book for   |    |
     | Outputed     |          | Spend %90 project|                |   Code-Monkeys   |    |
     | by compiler  |          | work here as it  |                |      AKA         |    |
     | unless there |          | is very important|                |     ALWAYS       |    |
     | are syntax   |          | and screens are  |                |     Follow       |    |
     | errors avoid |          | too few and too  |                |   Cpt Vince's    |    |
     | these at all |          | small            |                |     advice.      |    |
     | costs.       |------.   '------------------'                |    (CGRBFCM)     |    |
     '--------------'      |           |                           '------------------'    |
           /|\             |           |                                                   |
            |              |           V                                                   |
            |              |   .----------------------.                                    |
            |              |   | Formal Qualification |<-----------------------------------'
            |              |   |  Testing (FQT))      |                                    |
            |              |   | Dave does the actual |                                    |
                               | testing.             |                                    |
            |              |   '----------------------'                                    |
            |              |           |                                                   |
            |              |           |                                                   |
           \|/             |           V                                                   |
     .--------------.      |   .-------------------.               .------------------.    |
     |  Firmware    |      |   |Version Description|               |  Software Test   |<---'
     |  Support     |      |   |  Document (VDD)   |<--------------| Report (STR)     |
     |  Manual (FSM)|      |   |Make sure to update|               | Dave gives the   |
     |Dont even     |      |   |version number in  |               | thumbs up.       |
     |bother asking |      |   |code or you might  |               '------------------'
     |as we are way |      |   |think you have the |
     |behind our    |      |   |wrong version.     |
     |original ASAP |      |   '-------------------'
     |plan.         |      |
     '--------------'      |
                           |
                           |
                           |   .------------------.
                           '-->| Release to the   |
                               |     Customer     |
                               '------------------'
    
    

    2nd half

Children