# Be concise

<br />

Write concise error messages. Emphasize what's important. Cut unnecessary text.
See the
[Short sentences unit
of Tech Writing One](https://developers.google.com/tech-writing/one/short-sentences)
for tips on reducing sentence length.

Not recommended
> Unable to establish connection to the SQL database. *\[Explanation of how to fix the issue.\]*

Recommended
> Can't connect to the SQL database. *\[Explanation of how to fix the issue.\]*

*** ** * ** ***

Not recommended
> The resource was not found and cannot be differentiated. What you selected doesn't exist in the cluster. *\[Explanation of how to find valid resources in the cluster.\]*

Recommended
> Resource \<name\> isn't in cluster \<name\>. *\[Explanation of how to find valid resources in the cluster.\]*

*** ** * ** ***

Converting from [passive voice to active voice](https://developers.google.com/tech-writing/one/active-voice)
often makes sentences conciser and easier to understand:

Not recommended
> The Froobus operation is no longer supported by the Frambus app.

Recommended
> The Frambus app no longer supports the Froobus operation.

In your enthusiasm to be concise, don't remove so many words that the
resulting error message becomes cryptic. For example, don't reduce the
preceding error message down to the following:

Not recommended
> Unsupported.

### Multiple choice exercise

Reorder and shorten the following start of an error message.
How many words can you remove?

- The SiteID \<SiteID\> you have entered is invalid.
5 Yes. The error should read: Invalid SiteID \<SiteID\>. 4 That's a concise error message, but you can shorten the error message even more. 3 You can remove more words. None. This message is not concise. You can definitely remove some words.

<br />

<br />

**Next unit:** [Avoid double negatives](https://developers.google.com/tech-writing/error-messages/avoid-double-negatives)