levo

Implementation and System Security

Technical documentation

  • 3 things to know
  • AS Unit 1

Overview

What a maintainer needs that a user does not — the data structure, the module descriptions, the algorithms, the installation details and the reasons behind the decisions — and why it is written as the work is done.

What you need to know

Answer each one before you reveal it.

Your recallNot started
Key term

What is technical documentation?

Key term

Name five items found in technical documentation.

Key term

Who is the audience for technical documentation?

Questions from this subtopic

Each one with the model answer underneath.

  1. 1

    What is technical documentation?

    Model answer

    Technical documentation is the material written for the developers and support staff who will maintain, modify or reinstall a system.

  2. 2

    Name five items found in technical documentation.

    Model answer

    Technical documentation contains the system design and structure diagrams, the data dictionary, annotated program listings, the test plan with its results, and the hardware and software the system requires.

  3. 3

    Who is the audience for technical documentation?

    Model answer

    The audience is maintenance programmers, network and support staff, and any developer taking a system over from the team that wrote it.

  4. 4

    Why is technical documentation essential for maintenance?

    Model answer

    A programmer changing a system years later did not design it, and without the design and annotated code they would have to work out the whole structure before daring to change anything.

  5. 5

    What does a data dictionary give a maintenance programmer?

    Model answer

    A data dictionary gives the name, type, size and permitted values of every data item, so a programmer knows what a field holds before writing code that changes it.

  6. 6

    Why are algorithms and program listings both included?

    Model answer

    The listings show what the code does and the algorithms show what it was meant to do, and comparing the two is how a maintainer decides whether a difference is a fault or a deliberate choice.

Other ways to work this

The same content, four other ways.

What is inside Levo

Six ways to work the same material.

1Closed book
2Open book
3Closed book

The 3-step method, run for you

Answer cold, learn it, then prove it stuck. Levo tracks the jump between your first attempt and your last.

Systems Analysis and Development Approaches
Design, Development and Testing
Implementation and System Security
Programming

Cram a whole paper in one sitting

Sort every topic into what you know and what you do not, then drill only the weak ones.

A check requires a value.
presencerangeformat

Blank Blitz makes facts automatic

Rapid timed gap-fills on the terms and numbers you need to recall without thinking.

ANormal data is 12, which should be accepted.
BBoundary data is 1 and 50, which should be accepted.
C0 and 51, just outside the limits, should be rejected.

Build It gets the exam shape right

Assemble a full-mark answer from its marking points, in the order an examiner wants them.

One byte is made up of 8 bits.
TrueFalse

Test It catches misconceptions

Spot the fault in a statement. The traps are the mistakes students actually make.

721941163128510

Brain Breaks between sessions

Short focus games to reset attention, so the next set lands better than the last.

Every question in Implementation and System Security, on a schedule.

Attempt a question from memory, write the correct version, then attempt it again. Levo records the jump between your first attempt and your last, and brings each question back on the day you are due to forget it.

Or £46 a year, about £3.83 a month. Cancel anytime.