System diagramming

From Computer Science Wiki
Development[1]

A system diagram is a visual model of a system, its components, and their interactions. With supporting documentation, it can capture all the essential information of a system's design. There are many variations of diagramming style.[2]

Diagrams, if properly constructed, are excellent mechanisms to communicate complex information to others, much like a well-made technical drawing. Designing is, among other things, an act of communication, so making sure one has an accurate and relatively easy to read account of design decisions is important for communicating that information to others.[3]

System flow charts[edit]

Creating good system flow charts is a learned skill. You will need to practice. You will also need to create flow charts so they can be critiqued by a teacher.

In general:

  1. flowcharts must be of sufficient detail so another person can accurately describe how your program will work using only a flow chart
  2. flowcharts must not be cluttered. It is better to make 2 or 3 clear flowcharts rather than one visually cluttered one
  3. flowcharts should be transferrable to pseudocode

common mistakes[edit]

  1. students generally do not use conditional symbol correctly.
    1. A conditional symbol must have a yes/no true/false question with clear lines leading from the conditional
  2. students do not have a suitable level of detail

References[edit]