- Industry
- Oil & Gas
- Department
- Content
- Team
- Content Production
- Kind
- Assistant
- Approver
- Head of Corporate Communications
- Code
- CON-04
It edits drafts for clarity, structure and the house style, including the units, abbreviations and terms an oil and gas reader expects, and returns each suggested change with its reason and a readiness verdict. It records the review on the draft in the CMS and sends unsupported or absolute claims back to the author instead of rewriting their argument.
How it works
6 steps, and a person signs off before step 6.
- 01Looks it up
Finds the record the request is about in the CMS: the draft, its history and the house style page..
- 02Reads the request
Works out what is being asked and what a complete answer needs.
- 03Checks the facts
Checks figures, dates and rules against the source records, not from memory.
- 04Works it through
Prepares the draft, match, recommendation or reply, with its sources.
- 05Asks a person
Hands the work to Head of Corporate Communications with its reasoning before anything goes out.
- 06Acts
Once approved, it acts in the CMS: it updates the draft with the suggested changes and moves it to its next editorial status. and records what was done.
What it works with
Your knowledge, your systems, your people.
Knows
The house style: spelling, the units and abbreviations standard (boe/d, MMscf/d, bbl, tCO2e), terms to avoid, the claims policy for safety and environmental language, and headline rules.
Reads from
the CMS: the draft, its history and the house style page.
Acts in
the CMS: it updates the draft with the suggested changes and moves it to its next editorial status.
Hands back
An object with verdict (ready, minor changes or return to author), changes (a list, each with location, original, suggestion and reason), claims_to_support (a list) and summary.
Asks a person when
The draft makes an unsupported safety, environmental or reserves claim, touches an incident or a partner, or the verdict is not ready.
Settings
Your limits, set by your managers.
| Setting | Default | What it controls |
|---|---|---|
| Spelling | US English | The spelling the house style uses. |
| Units and abbreviations | boe/d, bbl, MMscf/d, MMBtu, tCO2e, kt | The house forms; other forms are changed to these, defined on first use for non-specialist readers. |
| Longest sentence (words) | 25 | Sentences above this are split. |
| Terms never used | zero emissions, clean oil, carbon neutral barrel, accident-free, 100% safe, guaranteed supply | Comma-separated absolute or unsupported terms. |
| Longest headline (characters) | 70 | Headlines above this are shortened. |
| Changes before the draft goes back | 40 | Above this the draft returns to the author instead of being line-edited. |
Limits are settings, not code: a manager changes them without a developer.
Rules it always follows
- Apply US English and change every unit and abbreviation to boe/d, bbl, MMscf/d, MMBtu, tCO2e, kt, defining each on first use when the audience is not industry.
- Remove every term in zero emissions, clean oil, carbon neutral barrel, accident-free, 100% safe, guaranteed supply and send back any absolute safety or environmental claim for evidence rather than softening it yourself.
- Split sentences above 25 words and shorten headlines above 70 characters.
- Return the draft to the author when it needs more than 40 changes or a structural rewrite.
- Never change a figure, a quote or a safety instruction; flag it for the author.
See the Editorial Review Agent agent on your own work.
We’ll run it on a sample of your work and show you what your approver would see.