Do you ask for content changes using from X to Y?
  v38.0 Posted at 29/01/2020 9:38 AM by Ulysses Maclaren
​​When asking for changes to be made to any file like a web page, Word document, PowerPoint slide or code, always include the original version of the content ("X") together with the changes you require ("Y"). This means you have at hand a history of the page or file as it currently stands allowing for convenient future reference and also makes it very clear to the person doing the changes exactly what the new file is meant to look like.

Make the changes even easier to see and understand by highlighting in red what you want to delete (only do this on the "From" section) and in yellow what you want to be added/updated (only do this on the "To" section).  All text we do not write ourselves should be indented, so this includes paragraphs we are copying and pasting (see Do you use indentation for readability?)

Hi Eric,

1. For the Code Auditor web page, please make the list read:

- Scan all your projects for coding errors
- Guarantee Industry best practices
- Friendly licensing model, bloggers even pay 0$ for the full version!

Figure: Bad example - original version of content has not been included in the email,

Hi Eric,

1. ​On the Code Auditor web page, please change http://www.ssw.com.au/ssw/codeauditor:

Change from:
     - Scan all your projects for coding bugs and errors
     - Enforce industry best practices
     - Friendly licensing model pay nothing for the full version!

    - Scan all your projects for coding errors
    - Guarantee industry best practices
    - Friendly licensing model, bloggers even pay 0$ for the full version!​

Figure: Good Example - it has 'From' and 'To' with changes highlighted... so it is clear what needs to be changed

If there are ​too many changes

​Sometimes you have a lot of content and too many changes, making the process "from X to Y" too arduous. In this case is recommended to use Word 'Track Changes' functionality.

Figure: A Word document with 'Track Changes' ON​ is recommended if you have too many changes​

Video: Top 10+ Rules to Better Email Communication with Ulysses Maclaren

Related rules

    Do you feel this rule needs an update?

    If you want to be notified when this rule is updated, please enter your email address: