Opens in a new tab
Skip to main content
Lesson 03 of 10

Read a Simple Change

Compare removed and added words before deciding whether an edit belongs in history.

About 10 minutesNo coding experience neededExplore in your browser

Look around. Try a small click.

This lesson works as a written guide with interactive examples. You can explore here before opening the real application or provider dashboard. A recorded video has not been added yet.

Read the short lesson

What will make more sense

  • Read removed and added wording using text labels.
  • Check whether a small wording change alters a business promise.

One idea to keep

Review what a change means before deciding to keep it.

The short lesson

Read the explanation at your pace

A change comparison is often called a diff. It answers a small question: how does one version differ from another? You already use this idea when you compare an old menu with a revised menu. In VS Code, the comparison can put the earlier wording beside the newer wording, or show both within one view. The layout may vary, but the reading task stays familiar.

The prepared example starts with this sentence: To book, call us during opening hours. The proposed sentence is: To request a booking, call us during opening hours. Only a few words change. That change matters because requesting a booking does not promise that the business has already confirmed the appointment. You are reviewing meaning, rather than just noticing that the new version sounds polished.

The browser example labels the earlier text Removed wording and the proposed text Added wording. Red and green reinforce the distinction, but you do not need color to understand it. Removed does not necessarily mean bad, and added does not necessarily mean good. They describe how the two versions differ. Either version could contain a mistake that needs attention.

Read the whole sentence around the changed words. If an assistant changes call us to book instantly, it has also changed the service promise. A spelling improvement would not justify that extra promise. Ask for a narrower revision or explain the requirement. A useful review asks whether the edit achieved the requested goal while preserving the facts and limits that should remain.

A comparison can show edits already written to the working file. It is not always a preview waiting for a single accept button. Before clicking anything, identify which versions are being compared and whether the file has already changed. You can ask the assistant to explain the comparison without applying more edits. Reading does not require permission to replace other work.

Try the Before, After and Compare both buttons. Then choose the interpretation that preserves the difference between a request and a confirmation. This is enough for a useful beginner review. You do not need to understand the marks around every line or learn the internal format of a change file. Focus on the words and the business outcome.

Try it here

Try it here · no installation needed

Review the booking sentence

Explore the prepared example, then choose a response. Your choice reveals its explanation immediately.

This is a local learning example with prepared responses. It does not run VS Code or contact an AI service.

− Removed wording · before

To book, call us during opening hours.

+ Added wording · after

To request a booking, call us during opening hours.

What does the proposed wording make clearer?

A tiny next step, if you want one

Optional: try 2 small actions at your own pace

You can finish this lesson by exploring the example above. These real-app actions are optional, and there is nothing to submit.

  1. Optional: open service-before.md and service-after.md side by side.
  2. Optional: ask your assistant to explain the booking difference without editing either file.

A quick confidence check

These checkmarks are a personal reminder. Choose what feels familiar, and come back whenever you want.

Your place is saved in this browser when storage is available. There is no grading or account sync.

Try a short question

Choose an answer to see why it fits. You can try again or explore every explanation.

Does added wording always mean better wording?

What should you read around a changed phrase?

If something looks different

The real comparison is arranged differently from the lesson.

Use its old/new or removed/added labels and ask which versions it compares. The exact panel arrangement can differ.

Sources and further help

Read the official product guidance and related learning resources when you need them. You do not need to read every reference now.