liveBook · Manning

Revision

Also called rework

Revision is the process of reviewing and modifying existing work to correct deficiencies or improve its quality, completeness, or suitability.

How 2 Manning books explain it

Writing for Developers: Blogs that get read

The process of reviewing, modifying, and improving a draft's content, structure, clarity, or correctness.

How it is used
Improves technical articles by aligning them with reader needs, strengthening important explanations, and preparing them for publication.
How deep it goes
Provides a staged revision procedure with read-aloud tests and prioritization, while de-emphasizing exhaustive grammar polishing and endless refactoring.
Examples
Uses timed drafting, out-of-order writing, read-aloud tests, grammar tools, AI prompts, second opinions, and internet checks.
What you can do after
Apply it via targeting criteria, read-aloud tests, timeboxes, grammar checkers, AI prompts, feedback, and final fact checks.

Read how Writing for Developers: Blogs that get read explains revision →

"Looks Good to Me"

Substantial modification of proposed software changes to address concerns about their implementation, scope, or correctness.

How it is used
Shortens prolonged pull-request review cycles by turning major rework into an explicit, collaborative clarification process.
How deep it goes
Explains causes, prevention, synchronous escalation, and review milestones, but does not specify implementation-level refactoring techniques.
Examples
Uses recurring pull-request rework, major reviewer revisions, unaddressed comments, offline conversations, and review milestones.
What you can do after
Apply direct reviewer-author conversations and earlier design clarification to reduce misunderstandings and repeated pull-request updates.

Read how "Looks Good to Me" explains revision →

Also covered in

What to know first

Related concepts

Questions about revision

What is revision?

Revision is the process of reviewing and modifying existing work to correct deficiencies or improve its quality, completeness, or suitability.

Which Manning books explain revision?

Writing for Developers: Blogs that get read and "Looks Good to Me".

What should I know before learning revision?

Manning books that teach revision usually introduce target audience and language model first.

What is the difference between revision and draft?

Revision is the process of reviewing and modifying existing work to correct deficiencies or improve its quality, completeness, or suitability. A draft is a preliminary version of content that is subject to revision or finalization.

What is revision also called?

Revision is also called rework.

These guides are generated from the text of Manning books by Manning's knowledge graph and link to the sections they draw on. The full books are available on liveBook and at manning.com.