Course / 01 Start / Lesson 03 of 09

How to take notes

Estimated time: 10 min reading · 10 min activity

When an activity stops working, a useful note helps you return to the same point. It also gives someone helping you enough information to follow your attempt. You can use paper, a text file or a private notebook; the fields matter more than the app.

An observation is something you directly saw or measured. An inference is an explanation you draw from evidence. For example, seeing an error is an observation; guessing why it appeared is an inference. Keeping them separate lets you revise an explanation without losing the original evidence.

Before you begin

Estimated time
10 min reading, 10 min activity. Setup and optional practice may take longer.
Where you work
Work on this lesson page in a desktop or mobile browser, with paper or a text editor for notes. You need no installation, account or terminal. The cases describe invented situations; your task is to read and reason about them.
Without a lab
Every worksheet appears in full on the page. A download saves a copy to your device; it is optional. If you cannot download, copy the fields into your notes. Without JavaScript, predict the decisions and explain your reasons on paper. Answer checking needs JavaScript; keeping the result after you leave also needs browser storage.

After this lesson you can:

  • Record the task, environment, action and exact result of an attempt.
  • Separate a direct observation from an untested explanation.
  • Remove sensitive information before sharing a copy of a note.

01Example

This invented note describes a worksheet link that fails to open. Read how it connects the action to the displayed result, then proposes a check. It is not an error observed on your device.

Task: open the lesson's practice worksheet
Environment: browser on a personal laptop
Action: select the worksheet link once
Observation: the page displays File unavailable
Inference: the link may use the wrong filename
Next check: compare the linked filename with the lesson's filename
Limit: use the supplied lesson information only

02Keep enough context

Start with the task: what you wanted to do. The environment describes where you tried it, such as the lesson page, program and device. Record the relevant version if you know it. A version identifies a particular release of a program; unknown is more useful than an invented number.

Next write the action and the result. Keep an error's exact words, because a summary such as it broke can hide the distinction between different failures. Later, when you learn commands, record what you typed beside what the computer returned.

A source is where your evidence came from, such as the worksheet card. A timestamp records when something happened and helps order repeated attempts. If the source supplies no time, write unknown. Notes should preserve missing information rather than silently fill it in.

03Mark the guess

In the example, File unavailable is the observation. A wrong filename is only one possible explanation. Comparing the two filenames could show whether that explanation fits. If they match, you need other evidence before deciding the cause.

Use separate lines for observation and inference. Write a next check that could support or weaken the inference. If a later check changes your mind, add the new evidence and explanation while keeping the original result.

Keep File unavailable as the observation, wrong filename as an untested inference, and the filename comparison as a next check.Model. A teaching model drawn by hand. It shows the idea, not real tool output.

Read the full explanation below.

The page displayed File unavailable.The link uses the wrong filename.Compare filenames before accepting the explanation.

Action

select the worksheet link once
Selected evidence · Fictional worksheet-link note

Observation

the page displays File unavailable
Selected evidence · Fictional worksheet-link note

Inference

the link may use the wrong filename
Source evidence · Fictional worksheet-link note

Next check

compare the linked filename with the lesson's filename
Source evidence · Fictional worksheet-link note
supported

The page displayed File unavailable.

The recorded observation supplies the exact displayed result.

No cause has been established.

Fictional worksheet-link note

The action and exact result are recorded; the cause remains open.

Follow the explanation

  1. The action and exact result are recorded; the cause remains open.
  2. Wrong filename is an untested possible explanation.
  3. A planned filename comparison is not a completed observation.
Read every state and value

1. The action and exact result are recorded; the cause remains open.

Evidence selected
Action · Observation
Current claim
The page displayed File unavailable.
Source origins
Fictional worksheet-link note

2. Wrong filename is an untested possible explanation.

Evidence selected
Observation · Inference
Current claim
The link uses the wrong filename.
Source origins
Fictional worksheet-link note

3. A planned filename comparison is not a completed observation.

Evidence selected
Inference · Next check
Current claim
Compare filenames before accepting the explanation.
Source origins
Fictional worksheet-link note
Keep File unavailable as the observation, wrong filename as an untested inference, and the filename comparison as a next check.

04Fill a note from evidence

Now use a different invented attempt: a learner tries to open a text file. A filename identifies a file; here it is practice-notes.txt. A folder is a place for grouping files. The ending .txt commonly indicates plain text. You are describing this attempt from the record, not opening a file on your own device.

Encrypted means transformed so that reading the content requires the appropriate key. You will study it later. An error message alone does not establish that content is encrypted. You need evidence that supports the particular cause you propose. Credentials means information used to sign in, such as a password.

FICTIONAL ATTEMPT
Task: read the supplied file practice-notes.txt
Environment: personal laptop; text-viewing program
Program version: not recorded
Action: select Open, then choose practice-notes.txt
Result displayed: File not found
Learner's guess: the file might have moved to another folder
Credentials supplied: none
Time: not recorded

Fictional file-opening attempt · plain text

Task:
Source of this record:
Environment and known versions:
Time (or unknown):
Action:
Exact observation:
Inference (not yet tested):
Next check:
Permission and limits:
Sensitive information removed before sharing:

Note fields to fill in · plain text

  1. Copy the template into your notes. Fill the task, source, environment and action from the fictional attempt. Use unknown for the missing version and time.
  2. Copy File not found into Exact observation. Put the moved-file idea under Inference, and keep its uncertainty visible.
  3. Write a next check that gathers relevant evidence without changing access. For this case, ask the lab author which folder should contain the supplied file.
  4. Review your note against the record. Another learner should be able to identify the attempted action and exact result. The note should not claim to know the cause or invent missing facts. Stop with the note; no searching or moving real files is needed.

05Protect the note

Before sharing a copy, remove passwords, private information and puzzle answers. A session token is a value a service can use to recognize a signed-in browser. Someone who obtains it may be able to misuse that access, so treat it as sensitive too.

Redaction means removing sensitive information or replacing it with a marker such as [password removed]. Keep the surrounding explanation so the note still makes sense. A screenshot, which is a picture of your screen, can include account names, other tabs and sensitive text in a web address. Review the whole picture before sharing it.

06Optional challenge

Allow about 5 extra minutes. Propose one piece of evidence that could weaken the moved-file guess without searching someone else's files. Explain how that evidence differs from repeating File not found. You can use a reply from the fictional lab author as the proposed source.

07Fresh cases for the checks

Use these fictional cases for the checks below. They have different inputs from the worked examples. Read them here or make notes; no installation or external service is needed.

Note case A: supplied transcriptOwned fixture. An original file made for this course. Follow the activity's instructions in your own lab.

Task: read lantern.txt from the supplied worksheet.
Environment: browser on a tablet; browser version unknown.
Action: select the lantern.txt link once.
Displayed result: Resource missing
Learner guess: the server is broken.
Worksheet names the file lanterns.txt.
No timestamp is supplied.
Private note also contains Password: [fictional-secret].

08Build the note

Optional written self-check: Write task, environment, action, exact observation, uncertain explanation and next check from case A. Keep the original record privately; remove sensitive values in a shareable copy. Your rubric is honest unknowns, a preserved exact result and a check that could change your explanation.

09Common mistakes

If you cannot download the template, copy its visible fields or write them on paper. The record contains all the evidence needed.

If your observation says only it broke, return to the record and copy its exact result. Keep your explanation on a different line.

If a version or time is missing, mark it unknown. Your own device's details do not belong in a note about this fictional attempt.

If your next step searches or moves real files, replace it with a request for the expected folder location. The record describes an invented attempt, and its cause remains uncertain.

References