Category Archives: Technical

What’s e-new?

By Andy Coulson

At the time of writing this I am in lockdown at home and realising the changes and compromises this means. Thinking back to when I started, technology has evolved so much that it has helped with these challenges in a way I couldn’t have imagined 15 years ago. So, I’ve compiled a list of technology-based or focused resources that I hope will prove of some help.

1. Help! How do I fix my computer?

I suspect this may be something we will all come up against sooner or later. The good news is that there are lots of good resources that can walk you through common problems. Even if your PC or Mac is down you can search on a smartphone and hopefully get yourself running again. Sites like wikihow.com; helpdeskgeek.com; dummies.com; techrepublic.com and Microsoft’s own answers.microsoft.com and support.microsoft.com are all helpful.

A carefully thought-through Google search will often be the best approach. For example, ‘Word 365 normal template’ gives good answers as to why Office 365 keeps flagging the normal.dotm as corrupted. It contains the version of Word and the specific item that is causing the issue. If your computer is giving a fault code or description, include that in the search too.

I’ve written before about backing up, spring cleaning and virus scanners, and all these tips and tools are still relevant. I’ve recently been pointed towards Microsoft’s Safety Scanner, which is an additional, occasional-use virus checker. It is good if you suspect you have a virus, as you can download and run a clean copy of the scanner (if you do have a virus, that may have compromised the scanner on your system).

Finally in this section, Microsoft Word itself is a prime cause of the air turning blue around my workspace. Again, Microsoft’s own support pages can be really good – support.office.com. Our own forums are also a good source of support (forums.ciep.uk), with many experienced word-wranglers being regular contributors. One of my favourite sources of help to answer ‘how to’ issues in Word is wordribbon.tips.net/index.html, and it is well worth subscribing to their newsletter.

2. Managing your time

While I’m at home I find I am facing two opposite problems with managing my time. The first is that it can be difficult to focus and stick at what you are doing. The second is the polar opposite of that: using work as a distraction and spending too long nose to screen. But we can use technology to help in both cases to nudge us in the right direction. I’ve written in the past about approaches based on the Pomodoro technique, which encourages you to keep going for a fixed amount of time, or conversely take a break from work after a fixed period of time. The suggestions here are two examples on that theme.

Forest is an app that tries to help you focus by making a game of focusing on a task. You set the timer for as little as 10 minutes through to 2 hours. Each time you start a stretch of work the app plants a virtual tree. Complete the stretch and you start a forest. Quit and your tree dies. It’s a simple idea and strangely addictive. You could use this either to build up your focus or to remind you to take a break.

Workrave is aimed at helping people recover from RSI, but is also a useful tool to encourage you to take breaks from the keyboard and mouse as you work. It produces gentle reminders, which you can configure, to take frequent microbreaks and longer breaks to step away from the computer, and you can even set a daily maximum.

3. Staying fit

Keeping healthy is one of the key things we are being encouraged to do, and there is a massive number of resources that have been made available in response to the lockdown. YouTube is a particularly good resource, and all the suggestions below can be found there.

Normally I’m a keen swimmer and cyclist, but am not getting very far (yes, pun intended!) with either at the moment. However, the Global Triathlon Network has a number of very accessible workout suggestions, despite the elite-sounding name.

If you have kids at home (or even if you don’t), Joe Wicks’s The Body Coach TV channel has a regular PE-with-Joe session. He also has a range of other home workouts that need little or no equipment and cater for a range of abilities.

Yoga is another home-friendly exercise, and I find it also helps undo the damage done by sitting in front of a computer for long periods. Yoga with Adrienne and Five Parks Yoga both offer a range of sessions, from basic, short beginner sessions through to longer, more advanced sessions. Headspace have also put a series of Move Mode sessions on YouTube, which are not traditional yoga, but more a meditative approach to movement.

Finally, I’ve really got into meditation as a way of having a break from everything. Headspace, Mindspace and Calm all have a range of shorter (10-minute) meditations freely available on YouTube. I am particularly enjoying some of Headspace’s Meditations from the American National Parks where you are encouraged to focus on sounds or colours instead of your breath.

I hope that is helpful to you. Stay safe, and we’ll hopefully get back to some more techie stuff next issue.

Andy Coulson is a reformed engineer and primary teacher, and a Professional Member of CIEP. He is a copyeditor and proofreader specialising In STEM subjects and odd formats like LaTeX.

 

 


‘What’s e-new?’ was a regular column in the SfEP’s magazine for members, Editing Matters. The column has moved onto the blog until its new home on the CIEP website is ready.

Members can browse the Editing Matters back catalogue through the Members’ Area.


Photo credits: Forest – B NW; keyboard Christian Wiediger, both on Unsplash

Proofread by Liz Jones, Advanced Professional Member.
Posted by Abi Saffrey, CIEP blog coordinator.

The views expressed here do not necessarily reflect those of the CIEP.

Why should editors pay any attention to readability metrics?

By Howard Walwyn

Like other things that are not universally loved but keep coming back – general elections and the X Factor – readability metrics don’t seem to be going away.

There are people out there who like general elections and the X Factor. And there are people out there who like readability metrics. But many who don’t.

“I thought that [setting readability targets] … had long since fallen out of fashion. It’s not a reliable tool, and it’s not appropriate in many circumstances.” (CIEP forum contributor, August 2018)

This view is by no means isolated and is very defensible. Far better to write like a human than to be constrained by over-simple metrics, which don’t capture nonsensical meaning and can be outright misleading about how ‘good’ – clear, simple or ‘readable’ – a piece of prose is.

Young shocked boy holding open book

Photo by Ben White on Unsplash

What are readability metrics?

A quick reminder of what the measures are, pretty much in two classes.

Flesch-type: Simple arithmetic measures of two elements: (i) the ratio of words to sentences and (ii) the ratio of syllables to words. In essence, shorter words and sentences translate to better readability scores.

Other: Widely used by Search Engine Optimisation (SEO) tools, a separate but related class of measures looks at frequency: how often something occurs and whether it is above or below a given threshold. For example if the number of sentences with a passive verb exceeds 10% the prose will be marked down on this metric. Similarly, the number of ‘long’ sentences as defined (20 words, since you ask) shouldn’t exceed 25%. And the number of sentences including a so-called ‘transition word’ should exceed 30%.

Why use readability metrics?

Why would any editor in their right mind pay attention to such simplistic notions?

Well, for two main reasons.

As a benchmark

In their own limited way – not sufficient, not even necessary, but still useful – these metrics support intuition surprisingly well. A postgraduate thesis will score around 30 on the Flesch Reading Ease measure. This is one version of the simple ratios mentioned above, scaled into an index which can be then attributed to different reading levels. 30 is hard to read. 60 is plain English. 100 is readable by an eight-year-old child.

I think of them as no more than benchmarks: background data in the back of my mind which helps me judge (1) the level of reader who find might this piece easily readable – which may be very different to who it is aimed at; and (2) how a piece compares before and after editing or compares to work by a similar but different author.

I emphasise that I fully understand the technical limitations. I wouldn’t judge a piece based solely on the metrics. But I do find the information they give me is valuable in its own terms as part of my assessment of the piece.

You can’t drive a car based solely on the speedo. You don’t even really need it that much if you’re an experienced driver. But it’s still a useful part of your armoury at the wheel.

Because clients do

This is perhaps the main reason in practice we, as editors, should be paying more attention even if we have to hold our noses while doing so.

Increasingly – perhaps reflecting the more general drive towards plain English standards in corporate and official life – non-publishing clients are using Flesch and other metrics explicitly as in-house writing targets. A couple of examples came up in a members’ forum thread on this topic.

“I do some work for a government department … their reports must have readability scores of between 40 and 60, varying according to their intended recipients.” (CIEP forum contributor, August 2018)

I can vouch for this. One of my clients in the finance sector has set external and internal Flesch readability targets for its comms department and its policy gurus respectively. The arguments are as follows:

  1. On the external (comms) side, they want to communicate in plain English and a Flesch measure is an objective way of at least encouraging that.
  2. On the internal (policy) side they want to improve their management decision-making, and clearer internal writing – which they think is at least partially evidenced by a ‘good’ Flesch score – is part of that determination.

We can help

On this basis it is pragmatic and sensible for us, as editors, to develop some expertise in the tools; while not losing any scepticism we may have for them. We can add value for clients by helping them understand the metrics better, and work with them to help them appreciate the limitations. As Luke Finley said on the forum thread I mentioned:

“There’s some evidence applying readability formulas too rigidly can make a text harder to read. To me this is an argument for putting them in the hands of language experts like editors if they’re to be used in a nuanced way.” (August 2018)

In short, keep an open mind. It could help you in your business if you have this expertise. I wouldn’t necessarily suggest volunteering them if the client doesn’t use them. But even that may be apt and valuable for certain types of non-publishing client. And you may help mitigate some of the misapplications that come with limited understanding.

You can even have fun with them. I expose my students’ work to the measures and they are often thrilled or horrified to see how academic (read tortuous) their business writing has become. And often pleased to be set on a path which involves a clear metric (even if a limited one).

Want to know more?

For more information I have published two (yes, two!) blogs on this topic, which I suppose reveals my interest: Flesh of my Flesch and The Pix Simplicity Measure.

And for a bit of further informative fun, here are the readability metrics for this blog:

  • Flesch Reading Ease 60 (plain English).
  • 24% of sentences are long; 12% are passive; within or close to the guidelines.
  • 34% of sentences with transition words: above the guideline.

In short, I am happy to release this post to the editor in the knowledge that it should be broadly ‘readable’, but you can be the human judge of that!

Howard WalwynHoward Walwyn is a writer, editor, trainer and CIEP Professional Member. After a career in the City, he now helps clients write clear business English and bridge the worlds of language and finance. He is a visiting lecturer in Writing for Business at City, University of London and has degrees in English Language & Literature and Economics. Follow him on LinkedIn or Twitter.

Posted by Abi Saffrey, CIEP blog coordinator.

The views expressed here do not necessarily reflect those of the CIEP.

How to customise PerfectIt to check your house style

By Daniel Heuman

PerfectItBuilding customised style sheets in PerfectIt helps make sure that all documents you work on reflect your or your client’s preferences for spelling, hyphenation, capitalisation, italics, and other house style choices. There are two ways to build preferences into a PerfectIt style sheet. You can either:

  • Commission Intelligent Editing to prepare the style sheet for you. For government departments, NGOs, and Fortune 500 companies, this is the best way to develop the most comprehensive style sheet possible.
  • Prepare the style sheet yourself. For freelancers and small companies, this lets you put together your own style sheet that is customised to your needs without any additional cost.

To have a style sheet prepared for you, you can get a quote from Intelligent Editing. This article is for people who want to prepare their own style sheet. It guides you through ten short videos that, in less than one hour, will teach you how to prepare your style sheet.

Do I need to customise PerfectIt?

PerfectIt doesn’t need any kind of customisation. You can use it to check consistency without altering any settings. Just run it, click ‘Start’, and the interface guides you through the rest. Most people find that’s all they need, without any customisation. If you haven’t ever used PerfectIt, start with the free trial, which you can download here.

PerfectIt also comes with a number of built-in styles, including European Union, Australian Government, World Health Organization, and United Nations styles. If you’re using those (or if you just want to check UK, US, Canadian, or Australian spelling), you can use the built-in styles without any customisation. Just select the style that you want before you press ‘Start’. You only need to customise PerfectIt if you want it to check your specific house style.

Creating a new style

If you’ve decided that you do want to customise PerfectIt and are ready to learn more, the first thing to do is to add a new style. This video explains how:

You can have one style sheet for every style manual (or client) that you work with. So repeat those steps for every style sheet that you want to create.

Customising settings

When you’ve created a new style sheet, you can edit it in PerfectIt’s style sheet editor. This video looks at the ‘Settings’ tab and shows how to check your preferences for lists, compounds, and headings. For example, you can set PerfectIt to enforce punctuation at the end of a bulleted list or to control title case in headings:

The next video shows how to use the settings for numbers in sentences and Oxford (serial) commas. You can turn Oxford commas off or on, and you can choose whether numbers in sentences should be spelled out or presented in numerals. In addition, it shows how to set a number of style points such as thousand separators and non-breaking spaces in measurements and dates:

Search and replace

You can modify PerfectIt’s tests by adding particular words that PerfectIt should find. In addition, you can choose words or phrases that PerfectIt should suggest as fixes. To see this, go to the ‘Always Find’ tab in PerfectIt’s style sheet editor. Each test within that tab is a little different. This video shows how to add searches to the tests of hyphenation, dashes, accents, and phrases in capitals:

The next video looks at PerfectIt’s different tests of spelling as well as the test of phrases to consider:

The final video on the ‘Always Find’ tab covers the test of comments that are accidentally left in the text and the test of abbreviations that appear in two forms. Then there is a more advanced tip on adding exceptions:

Additional tests

PerfectIt’s style sheet editor has tabs for PerfectIt’s tests of italics, prefixes, and superscripts and subscripts. This video covers all three, and shows how, in addition to switching the settings, you can add additional words/phrases to each test:

If you’re not familiar with wildcard searches in Word, it’s worth reading up on those before watching the next video. Two great sources to look at are Jack Lyon’s Advanced Find and Replace for Microsoft Word (an especially good resource for beginners) and Graham Mayor’s article on Finding and Replacing Characters Using Wildcards (a useful reminder for users who are already familiar with the concepts of wildcard search).

For those who are comfortable with wildcards, this video shows how you can include them in a PerfectIt style sheet:

An even easier way

The videos above explain all of the features in PerfectIt’s style sheet editor. However, if you’re concerned about the time involved in entering all the preferences in your style manual, there is a way to complete the task gradually. And it’s really easy. This video shows how you can amend a style sheet as you work without ever opening up PerfectIt’s style sheet editor:

Sharing styles

The great thing about style sheets is that it only takes one person to prepare them. After that, you can share the style with anyone at your organisation. This video shows how to share your style:

Slow and steady…

If you have spare time to set aside to prepare a style sheet, that’s fantastic. But that’s a luxury that many people don’t have. So what we recommend is to start with an existing style and amend that (as shown in the first video above). Then go through and complete the preferences in the ‘Settings’ tab (the second and third videos). Then stop and just do a few minutes per day after that. Adding to styles incrementally as you work is easy (the ninth video). And if you add just two or three items to a style sheet with each document you check, then you’ll quickly have a style sheet that saves time and improves checking for everyone at your organisation. And it doesn’t cost a penny extra!

Daniel HeumanDaniel Heuman is the Founder and CEO of Intelligent Editing as well as the developer of PerfectIt.

 

The views expressed here do not necessarily reflect those of the SfEP.

How to style web addresses

Here’s a question I’ve seen a few times of late: when writing out web addresses, must we include the whole address or is it safe to omit part of it?

Some house styles set out guidelines for writing web addresses. One would think, then, that the practice is simply a matter of style. In fact, it mostly is – but not always.

So that we know the names of the components that make up a web address, let’s take a look at an annotated example:

Components of a web address: infographic showing the protocol, subdomain, domain, and trailing slash.

Keeping with protocol

Web addresses begin with a ‘protocol’, the most common being http:// and https://.

From the technical point of view, the protocol isn’t usually required when quoting web addresses. To use the CIEP’s own website as an example, all modern browsers will treat the following addresses as equivalent:

When it comes to being consistent, we wouldn’t usually want both styles of web address to appear in the same piece of work.

The complications tend to come about when we start introducing addresses with other protocols to the same document. For example, if we wanted to make specific reference to a secure website, it would be correct to indicate this by including the protocol in the address, such as:

The intelligent reader will see the protocol and immediately understand that the website is secure, regardless of any other information about the site in the text.

Secure areas

Almost every website that has a secure area will also have rules that discreetly redirect users from the standard protocol (http://) to the secure protocol (https://). To demonstrate this, one can visit the following address:

Now, because a protocol hasn’t been included in the example above, the browser will try to take the user to the http:// version of the site (this is the default behaviour of all web browsers). Seeing that action, the server running the website will automatically and immediately redirect the user to the https:// version.

In short, this means that, even for secure websites, a protocol isn’t usually required in the address. I write ‘usually’ because there are some rare cases where web servers may display the wrong page if the secure protocol is not specified.

In cases where any protocols are included so as to give the reader a cue, it stands to reason that all other web addresses in the same document should also include protocols, on grounds of consistency.

In a document where standard web addresses are the only ones used (i.e., http:// and nothing else), it seems unnecessary to include the protocol. Omitting the protocol is both consistent and technically correct.

Handling new domain names

One common reservation with omitting protocols is when it comes to the newer domain suffixes, many of which most readers may not have heard of. Here are some examples:

If you saw these in running text, would you know that they were web addresses? Or might you think they were the ends and beginnings of unspaced sentences? The caveat here is that if unusual or novel addresses are used in a document, they might be worth qualifying with a protocol – and in turn that would require every other address in the document to include a protocol, too (on the assumption that we’re going to be rigid about consistency).

The cautious editor could use this argument to recommend that protocols be included on all addresses, to prevent a major rekeying effort in the event that some novel address is later added to a work that had previously contained only run-of-the-mill addresses. You’d have to make a decision about whether this would be too cautious an approach. For what it’s worth, I’ve been omitting protocols for quite a while now, having previously been a staunch supporter of mandatory inclusion.

Omitting the ‘www.’ part of an address

Some people don’t know that it’s usually possible to omit the ‘www.’ part of a web address and still be able to retrieve the website. This part of the web address is known as the ‘subdomain’. Most web servers are set up so that the domain (the key part of the address) and the ‘www.’ subdomain each allow access to the website. Here is an example:

Unfortunately, it’s not always possible to omit what would otherwise be a redundant ‘www.’ from the address. Here are some examples:

Trailing slashes

A trailing slash is the forward slash character (/) sometimes added to the end of a web address. This should be added only to the end of a domain name or a folder name in the address. Here are some examples:

  • www.example.com/ – correct
  • www.example.com/folder/ – correct
  • www.example.com/folder/file.html/ – incorrect

One might wonder why a trailing slash would ever be added to a web address, given that the website ought to be displayed just as well without it. The answer is that the appropriate use of the trailing slash eliminates one unnecessary request from your computer to the server, thereby reducing the load on the server. You might not notice any positive effect, but it’s still a good practice to adopt: very busy servers will run better if their load is lightened in any way.

Web addresses followed by punctuation

A web address directly followed by any punctuation mark has the potential to confuse, because some readers may incorrectly interpret the punctuation mark as being part of the address. Word processors and email programs can sometimes be guilty of this mistake, turning an otherwise correct address into a link that doesn’t work when clicked. Thankfully, this is less of an issue than it once was.

It’s quite easy to fall foul of the ‘address plus punctuation’ problem when copying and pasting an address. It’s therefore sensible to avoid directly following an address with a punctuation mark; however, if the context is clear or the readership is web savvy, there may be no need to reword the text.

In my opinion, the omission of a terminal punctuation mark for the sake of clarity is preferable to the occasional practice of adding a space between the address and the punctuation mark. As usual, we should be consistent in the handling of all such matters.

Conclusion

If your client’s style guide sets out preferences for how to write web addresses, you should of course follow those preferences. But be mindful of any newer types of address that might confuse readers, and check that all addresses do indeed work as written.

If you have no style guide from which to work, remember that it’s perfectly fine to use the shortest possible address that will result in the desired website being loaded correctly.

John Espirian, a light-skinned person with short grey hair and glasses.John Espirian (@espirian) was the CIEP’s (then SfEP’s) internet director and principal forum administrator.

As a freelance technical writer, John specialises in producing online help content that’s actually helpful. He is also a relentlessly helpful LinkedIn nerd.

 

Proofread by CIEP Advanced Professional Member Etty Payne.

The views expressed here do not necessarily reflect those of the CIEP.