Revision
Revision is the process of reviewing and modifying existing work to correct deficiencies or improve its quality, completeness, or suitability.
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.
Also covered in
- Architecting Autonomous Agentic SystemsIn early access (MEAP)
- WordPress Power Toolkit: Harness AI to build next-level websites
What to know first
- target audienceA target audience is the intended person, group, or system that a product, service, program, or communication is designed to serve or reach.
- language modelA language model is a computational model of linguistic sequences that estimates their probabilities or predicts tokens from context, enabling it to generate or evaluate language.
Related concepts
- feedbackused by · Feedback is information or evaluation about an action, system, or outcome that can inform assessment or subsequent decisions and behavior.
- continuous improvementused by · Continuous improvement is a recurring process of using outcomes, observations, or feedback to guide changes intended to improve a system, process, or result.
- product visionconfigured by · A product vision is a motivating description of a desired future product state, value, or experience that provides long-term direction.
- change trackinguses · Change tracking is the process of identifying or recording modifications to an evolving artifact or state over time.
- draftcontrasts with · A draft is a preliminary version of content that is subject to revision or finalization.
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.

