Chapter 11
Reviewing: comments, changes, Review
A text is rarely finished the first time. Someone reads it, asks questions, crosses something out, suggests something else. You note passages you want to check later. This chapter shows how Goethe Write collects all of that in one place so that nothing gets lost.
You will meet five things: the Review tool, which shows everything still open; comments on a passage; tracking changes; revisions, the rounds of your rewriting; and snapshots for saving, comparing and approving. At the end comes the exchange with Word, for when your editor, publisher or law firm works in Word.
Note: In the English interface, two things are called “Review”: the Review tab of the ribbon (and the Review menu) and the Review tool, the page that collects everything open. This chapter says “the Review tab” and “the Review tool” where it matters.
All commands are in the ribbon on the Review tab and in the Review menu. Both carry the same commands, with the same name and the same shortcut (see Chapter 3).
The Review tab at a glance
| Group | Commands |
|---|---|
| Check | Spelling (⌘:), Check Paragraph (⌃⌘P), Word Count…, Review |
| Comments | Comment (⇧⌘K), Previous, Next, Delete |
| Changes | Track Changes (⇧⌘E), Accept, Reject, Previous, Next, Show |
| Revisions | Start Revision…, End Revision, Remove Revision Color, All Revisions… |
| Snapshots | Save Snapshot, Compare…, Approve…, Earlier Versions… |
| Word | Send as Word…, Apply Edits… |
A few commands appear only in certain types of work: Revisions exist in projects with the fiction tools (Novel, Screenplay), Approve… in Law and Consulting, Check Paragraph in Law, Academic and Consulting. If a command is missing, switch it on under Project ▸ Tools… (Chapter 2).
The Check group
- Spelling (⌘:) checks from the insertion point, or the whole text without a selection. The arrow chooses what is checked while you type: “Check Spelling While Typing” (underlines misspellings as you type), “Check Grammar with Spelling” and “Correct Spelling Automatically” (corrects common typos on its own). More in Chapter 4.
- Word Count… counts the words, characters and pages of the text and of the selection.
- Check Paragraph (⌃⌘P) checks the statements of the paragraph against their evidence. It opens a sheet with the Results: evidence, citations, cited statutes, terms, values, amounts, dates and cross-references of the paragraph are held against the rest of the project. Each result has a button that takes you to the matter, such as “Create Evidence”, “Go to Definition” or “Open Target”. Where a cross-reference leads nowhere, you see “Broken Cross-Reference” with the reason. If the check finds nothing, it says so: “Nothing Found”.
- Review opens the collection point for everything still open (next section).
The Review tool
What it is for
The Review tool is the place for everything waiting for you: notices from the checks and from Goethe, comments, questions, changes and evidence that still needs checking. Instead of hunting through every text, you open one list. The page's heading says it: “Everything Waiting for You”.
Example from writing practice: You have a novel with 40 chapters. Your editor left twelve comments, you noted three questions yourself (“When does Mara arrive in the city?”), and the checks report two notices. Everything is in one list, and you work through it from top to bottom without opening a chapter that has nothing open.
Opening the Review tool
You can reach it in four ways:
- Ribbon: Review tab, Check group, Review button.
- Sidebar: the Review row in the Project section.
- Menu Go ▸ Review.
- The head of the window: the phase Revision.
Reading the page
The Review tool has two halves. On the left is the list of Findings with the number of entries; on the right are the details of the chosen entry.
At the top you see the number of open entries (“12 open”) and the New Question button. Below sits a row of filters, each with its count:
| Filter | What is in it |
|---|---|
| All | everything together |
| Notices | findings of the checks and of Goethe, for example “Knowledge Too Early”, “Payoff Before Setup”, “Character Absent Long”, “Source Unchecked”, “Differing Amount”, “Claim Without Evidence” |
| Comments | comments with their replies |
| Questions | open, decided and dropped questions |
| Changes | tracked changes that someone still has to accept or reject |
| Evidence | evidence that is unchecked or needs checking again |
Each row of the list shows the symbol of its kind, a title, a second line with the main point (for a comment, the number of replies and the passage), and below it where it is, who created it and when. Settled items carry their label, such as “Resolved”.
The search field “Search title, text, passage, or person” filters the list. For comments it searches the replies too.
The View menu offers:
- Sort: “Order in Project”, “Newest First”, “Type” or “Person”,
- Show Resolved and Show Intended (both off by default),
- Reset Person and Section, if you have filtered by a person or a section.
When everything is done, the list says “No open review items in the project.” If nothing matches your filter, it says “No entries for this selection,” and “Reset Filters” brings everything back.
Working on an entry
- Click a row. On the right appear the kind, state, person and date, the title, the Passage with its wording and the details.
- Decide with the buttons at the bottom. They fit the kind of entry (see the table).
- Go to Passage (or a double-click on the row, or ↩) takes you into the text. The Open in Text button beside the passage does the same.
- Next Entry moves on in the list. If you settle an entry and it drops out of the list, the Review tool picks the next one for you.
| Kind | Buttons |
|---|---|
| Notice | “Mark as Checked” (where checking is the point), “Intended” hides the notice; “Show Notice Again” brings it back |
| Comment | “Mark as Resolved” or “Reopen”; the conversation with the replies stands below |
| Question | “Decide…”, “Discard…”, “Edit…”; for a settled question “Reopen” |
| Change | “Accept” and “Reject” |
| Evidence | “Mark as Checked” or “Mark as Unchecked”, “Open Source Alongside” |
Tip: A notice you meant on purpose should stop bothering you. Mark it Intended. It disappears from the list. “Show Intended” in the View menu brings it back. That keeps the list honest: it holds only what is still to do.
Asking, deciding and dropping questions
A question is a note to yourself or your team that stays open until it is settled. It has a title, an explanation, a person who takes care of it and the passages it concerns.
To ask a question:
- Select the passage in the text. This is optional.
- Right-click ▸ Ask Question…, or click New Question in the Review tool.
- Write the question in the “Ask Question” sheet, for example “Who wrote the letter?” An explanation is possible.
- Enter a name under Responsible. Your own name is already there.
- Click the main button of the sheet. In the English interface it is labeled “Passages”.
To settle a question:
- Choose it in the Review tool, then Decide… or Discard….
- When deciding, you write what applies. It then appears with the question and at its passages.
- For both you write the reasoning. It is required, and for a decision so is the decision itself. Without them the button stays grey.
- Under Decided by your name stands. Name and date are recorded.
- Confirm with Decide or Dismiss. The passages are submitted for review.
You can bring a decided or dropped question back with Reopen.
Example from writing practice: In a crime novel you wonder: “Does the inspector already know in chapter 12 that the door was open?” Ask the question at that spot in chapter 12. If you later decide “No, he learns it only in chapter 15,” you record that as the decision. The passages are submitted for review, and you see whether chapter 12 still fits.
The details in the Inspector
When you choose a row in the Review tool, the Inspector shows its details too. With no row chosen, it shows the page's filters. That way you can stay with the Inspector while you work in the text. More about the Inspector in Chapter 3.
Comments
What a comment is
A comment is a note on a passage of text. It works like a conversation: someone writes something in the margin, others reply, and when the matter is settled it is ticked off as resolved. In the text, the passage appears in the color of the person, with a speech bubble in the margin. A click on the bubble opens the conversation.
Example from writing practice: Your editor marks the sentence “He walked slowly to the door” in chapter 3 and writes: “Too many adverbs in this scene.” You reply: “I’ll cut two.” When you have done it, you tick the comment off. It leaves the list of open comments but stays readable.
Writing a comment
- Select the passage in the text. If you select nothing, the comment refers to the paragraph at the insertion point.
- Choose Review ▸ Comment (⇧⌘K).
- In the main window the Inspector opens with the new comment. The insertion point is already in the “Write a Comment” field. In the full text, the conversation appears in a window beside the passage.
- Type your text.
If you leave a comment empty and without a reply, Goethe Write removes it again when you close the window (“Remove Empty Comment”).
Who writes stands at the comment with name and date. You set the name under Settings… ▸ General ▸ Comments and Changes. There you find Name (“Appears on your comments, approvals, and changes”; left empty, the name of your Mac account applies) and Initials (they appear on your comments in Word; left empty, Goethe makes them from your name). More about settings in Chapter 20.
Holding the conversation
A comment shows, from top to bottom:
- the round check mark. It is empty while the matter is open, and a click resolves it (“Mark as Resolved”). When set, it reads “Resolved; Reopen”.
- the person with a dot, the date and, when you point at it, a ⋯ menu (“More Commands”),
- the passage in quotation marks. A click on it takes you to the passage (“Go to Passage”).
- the comment text, which you can edit directly,
- the replies, in long lists only the last two and “N more replies”,
- a Reply field. ↩ sends the reply. There is no send button.
The context menu (right-click on the comment) offers: Goethe…, Go to Passage, Make Open Question… (turns the comment into a question of the Review tool) and Delete. You delete a single reply from its menu with “Delete Reply”.
When the passage changes
You keep writing, and the text around a comment changes. The program notices:
- If the words of the passage were changed, the comment says “The passage has changed since.” Point at it to see what stood there before.
- If the passage was deleted, or its text is in “Recently Deleted,” it says “The passage no longer exists.” or “The text is in ‘Recently Deleted.’” The Find Passage button looks for the words again, first in the comment’s own text, then in all others. If it finds them, it attaches the comment there again (“Re-Anchor Comment”).
Going through the comments
- Next Comment and Previous Comment go to the next or previous open comment in the whole project, in the order of your manuscript. The comment opens in the Inspector. If there is no open one, a line under the command says: “No open comments in the project.”
- Delete (arrow) offers “This Comment” (the one the insertion point is in) and “Delete Resolved Comments in Text” (after asking). If the insertion point is in no comment, the first item is grey, with the reason “The insertion point isn’t in a comment.”
Tip: To tick off many comments at once, take up the Review tool with the Comments filter: there you settle them one after another and see the number of open ones fall.
Showing and hiding comments
In View ▸ Marks you switch, per kind, what the text shows: Comments, Changes, Evidence, Statutes, Marks. The default is everything on. Comments are tinted in the color of the person and have a speech bubble in the margin.
Track changes
What “Track Changes” does
When you switch on Track Changes, Goethe Write records from then on who inserts and deletes what. Insertions appear underlined, deletions stay struck through, both in the color of the person who made the change. Nothing disappears: you decide later whether a change stands.
This is the way of working you know from editing: the author sees what the editor struck out and can accept or reject every change one by one.
Example from writing practice: A friend proofreads your manuscript. You switch on tracking and hand her the project. She strikes “suddenly” and writes “then.” You see “suddenly” struck through and “then” underlined. If you do not like the change, you reject it, and the word stands as before.
Switching it on
- Choose Review ▸ Track Changes (⇧⌘E), or the switch in the band.
- First, Goethe Write saves the text you have open as the snapshot “Before Track Changes.” So you can always go back.
- Write or delete. Every change is recorded. To switch off, choose the command again (it then reads “Stop Tracking Changes”).
Who makes the change stands at it with name and date. Suggestions from Goethe that you take into the text also arrive as tracked changes by “Goethe”: “Deleted text stays visible until you accept; rejecting restores the passage.” (Chapter 16)
Accepting and rejecting
Accept takes a change over: insertions stay, deletions disappear. Reject discards it: insertions disappear, deletions stay.
| Command | What it does |
|---|---|
| Accept Change | Accepts the change at the insertion point; if there is none, it shows the next one in the project, and a second click decides it. |
| Reject Change | Rejects the change at the insertion point; otherwise it shows the next one in the project. |
| Accept / Reject All in This Text | Decides all changes of this text at once. |
| Accept / Reject All in Project | Decides all changes in all texts, after asking. |
The arrow of the Accept and Reject buttons offers the three levels. Step by step:
- Go to the first change with Next. It is shown in the text.
- Choose Accept or Reject. The next change follows if it begins right at the same spot.
- With Previous you go back.
For “All in Project”, Goethe Write asks first: “Accept All Changes in the Project?” and says how many changes there are in how many texts. A snapshot of each affected text is saved first (“Before ‘Accept All Changes’”) because accepting cannot be undone. You find them under Inspector ▸ Snapshots.
Filtering by person
The Show button in the Changes group chooses whose changes you see: “All People” or a single person. This applies in the text, in the Review tool and for “Accept All.” So you can accept all of your editor’s changes first and leave the colleague’s standing.
Tip: If you only want to read the clean text for a while, switch the Changes off under View ▸ Marks. The changes are then only hidden, not decided.
Before the export
When you export, the check before output shows you, for example: “3 changes await acceptance.” In Word they stay tracked; PDF and e-book show the text as if all were accepted (Chapter 14).
Rounds
What rounds are for
A round (a “revision” in the app) is a stretch of your rewriting with its own name, goal and color. While the round runs, new text appears in the color of the round. That way you see later what came in during which pass. Rounds exist in projects with the fiction tools, that is, Novel and Screenplay.
Example from writing practice: In the first pass you tighten chapters 1 to 3; in the second you rewrite the ending. Name the rounds “Tightening” and “New Ending.” Everything that is new from the second pass you later see in a different color than the first.
Starting a round
- Choose Review ▸ Start Revision….
- In the “Start Revision” sheet, enter a name. If you leave the field empty, it is called “Revision 1,” “Revision 2” and so on.
- Enter a goal, for example “Tighten chapters 1 to 3”.
- If you like, enter under Words at the end of the revision (optional) the number of words the manuscript should have at the end.
- Click Begin.
The note in the sheet explains the color: “During the revision, new text appears in its color. Remove Revision Color turns it back into text without a color of its own; the export prints black anyway.” Only one round can run at a time. While one runs, “Start Revision…” is grey with the reason “A revision is already running.”
Ending a round
Choose End Revision. New text then has no revision color. The command is grey when no round is running (“No revision is running”). In the band, the same place always shows the command that applies right now.
Removing the revision color
To take the revision color off a piece of text, select it and choose Remove Revision Color. It becomes text without a color of its own again.
All revisions
All Revisions… shows the running revision with its goal (and the date since when it runs) and below it the Earlier Revisions with start and end. The running one has an End button. “The color shows in the text what was added in which revision.” If none is running, it says “No Revision Running” and offers “Start Revision.”
Snapshots, compare, approve
What a snapshot is
A snapshot is a saved state of a text, like a photograph of it. You can go back to it at any time, compare it with the current text or bring back single paragraphs from it. In Goethe Write the word “version” always means only this, never the status of a text (that is called status; see Chapter 6). How snapshots differ from automatic backups is in Chapter 15.
Saving a snapshot
- Choose the text in the sidebar (or click into it).
- Choose Review ▸ Save Snapshot.
- The text is recorded as it is now, with the name “Snapshot of” plus date and time.
If no text is chosen, the command is grey with the note “Choose a text whose snapshot you want to save.” The same job is done by Entry ▸ Save Snapshot and the context menus of the sidebar. There you can also save several entries at once.
Saving as an alternative
The arrow beside “Save Snapshot” offers Save as Alternative. An alternative is a variant you can return to: “Alternative of” plus date. It helps when you want to try something without losing the earlier state.
Example from writing practice: You are unsure whether the prologue sounds better in first or third person. Save the present snapshot. Rewrite. If you do not like it, restore the snapshot. If you like both, save the variant as an alternative and decide later.
Looking at the snapshots: Earlier Versions
Earlier Versions… opens the Snapshots page in the Inspector. It shows all the ways back that exist for this text:
- Snapshots: states of this text that you saved,
- Deleted Passages: longer passages you deleted. They are kept, even after closing,
- Recently Deleted: deleted entries, until you delete them permanently,
- Backups: the whole project, day by day,
- Revert To: the versions macOS keeps (File ▸ Revert To).
Each snapshot row shows name, date and word count. With a right-click or the buttons you can Compare it, Restore it (for an alternative it reads “Use This One”), Rename it or Delete it. When restoring, the current text is saved as a snapshot first, so you lose nothing.
Comparing snapshots
Compare… shows the last snapshot next to the text as it is now.
- Choose the text you want to compare.
- Choose Review ▸ Compare…. If there is no snapshot yet, the ribbon answers with a sentence under the command: “This text has no snapshot yet. ‘Save Snapshot’ creates the first one.” With no text chosen, it reads: “Choose a text on the left to compare it with a snapshot.”
- The sheet Compare Snapshots opens.
- With the two pickers First Snapshot and Second Snapshot, choose what to compare: the Current Text, a saved snapshot or an alternative. The arrow in the middle (Swap Sides) exchanges the sides.
- The three switches below choose what you see: All changes, What came in (with the number of new words) or What fell out.
- The checkbox Unchanged Paragraphs also shows the paragraphs that stayed the same. Otherwise they are folded into a line like “3 unchanged paragraphs.”
The comparison is paragraph by paragraph, moved paragraphs included. Each change carries its kind: New, Deleted, Changed, Moved. Under the row it says how many words came in and how many fell out. Formatting alone does not count as a change.
Bringing things back: if one side is the current text, you can take over single changes.
- At a paragraph, click Apply (or Remove). The current text changes at that place.
- At a heading, Apply Section (or “Restore Section”) takes the whole section up to the next heading of the same level.
- Restore Whole Snapshot (bottom left) sets the whole text to the state of the snapshot. For an alternative the button reads “Use Whole Alternative.”
- Done closes the sheet.
Before each takeover the current text is saved as a snapshot, and ⌘Z in the text undoes it.
Example from writing practice: You cut a chapter hard and regret two paragraphs. Compare the chapter with yesterday’s snapshot. At the two deleted paragraphs, click Apply; the rest stays cut. You kept the cuts and rescued only those two paragraphs.
Approving
Approve… records a snapshot with name and date and first checks what is still open. It is meant for texts that become binding, such as a brief before filing or an opinion for a client. The command appears in projects with the tools for Law or Consulting.
- Choose the text.
- Choose Review ▸ Approve….
- Goethe Write asks “Approve ‘Title’?” and says what is still open: “Still open: 2 changes and 1 open comment.” or “Nothing is open anymore.” It adds: “A snapshot ‘Approved by (your name)’ is saved with today’s date.”
- Click Approve.
The snapshot then carries the name “Approved by (your name) on (date).” The Snapshots page of the Inspector also offers “Approve…”, in the context menu of the “Save Snapshot” row.
Exchanging with Word
Why Word?
Many editors, publishers and law firms work in Word. Goethe Write does not leave your comments and changes behind for that: they go into the Word file, and what comes back is worked cleanly into your project, without anything being overwritten.
Send as Word
- Choose Review ▸ Send as Word….
- The export sheet opens already set to Word (.docx) with Include Comments and Changes switched on.
- Check the other settings, for example the scope, and export (Chapter 14).
- Send the file.
Your comments arrive as Word comments with their replies, resolved ones as resolved. Your tracked changes arrive as Word insertions and deletions with person and date. The file asks Word to track your editor’s changes. Invisible marks in the file let Goethe Write recognize later which text belongs to which text of the project.
If you want a clean file without comments and changes, switch off “Include Comments and Changes” in the export sheet.
Apply Edits
The editor sends the edited file back.
- Choose Review ▸ Apply Edits….
- Choose the .docx file. The note in the dialog says: “A Word file exported from Goethe Write and edited by an editor or a law firm.”
- Goethe Write reads the file and shows a summary before anything happens: “Apply Edited Word File?” with what would change. If nothing changes, it says “Nothing to Apply.”
- Click Apply. With Cancel, everything stays as it was.
- The program opens the first changed text with the Snapshots page in the Inspector.
What happens:
- Nothing is replaced. A snapshot of each text is saved first.
- Differences arrive as tracked changes in your project, with the name of the person from Word and the date. What was deleted in Word stays marked as deleted, and insertions come in marked as inserted. Edits made in Word without tracking are marked as changes by the last author of the file.
- Comments arrive as comments.
- What the editor already accepted or rejected in Word is thereby settled in Goethe Write, but only if the text is as you exported it.
- Your own changes that went along and came back stay as they are.
- If you apply the same file twice, nothing changes the second time.
- You then decide on each change in Goethe Write (see “Track changes”).
Word has things Goethe Write has no model for: formatting changes, moved paragraphs, endnotes. They are mapped onto what Goethe Write has. Word thus serves as an exchange format, not as a second home for your project.
If something fails, Goethe Write says so in one sentence:
| Message | Meaning |
|---|---|
| “The file can’t be read as a Word document.” | The file is damaged or not a .docx file. |
| “The Word file belongs to another project: none of its texts are in this project.” | You chose the file of another project. |
| “‘Title’ doesn’t appear in the Word file.” (shown with the title of the missing text) | The editor removed a section. |
| “The Word file doesn’t come from Goethe Write or has lost its section marks. Choose a single text to bring it into.” | Choose in the sidebar the text the file should go into, and start Apply Edits… again. |
Example from writing practice: You send your nonfiction book as a Word file to an editor. She works two weeks in Word with tracked changes and comments and sends the file back. You choose Apply Edits…, check the summary and apply. In the Review tool you see all comments and changes in one list. You accept the good changes, reply to the comments and reject the rest. Your original has been protected by snapshots the whole time.
Further reading
- Chapter 3: The workspace: ribbon, Inspector, sidebar
- Chapter 14: Output and export: Word, PDF and the check before output
- Chapter 15: Saving, versions and backups
- Chapter 17: Collaboration with Goethe Link: comments and suggestions from guests
- Chapter 26: Workflows from writing practice: editing with comments and tracked changes