From a058a09b9bd28d633d2177fed1ccf66e202bb54e Mon Sep 17 00:00:00 2001 From: Ursula Kallio <73951760+osg-grafana@users.noreply.github.com> Date: Wed, 11 Aug 2021 11:30:40 +0200 Subject: [PATCH] Include voice and tone summary (#37742) Fix https://github.com/grafana/technical-documentation/issues/35. --- contribute/style-guides/documentation-style-guide.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/contribute/style-guides/documentation-style-guide.md b/contribute/style-guides/documentation-style-guide.md index b8f6035d60f..4d07e8d3e2b 100644 --- a/contribute/style-guides/documentation-style-guide.md +++ b/contribute/style-guides/documentation-style-guide.md @@ -50,6 +50,10 @@ The following guidelines are specific to Grafana documentation. For the most par ### General +Per the [Voice and tone](https://developers.google.com/style/tone) section of the Google developer documentation style guide: + +> In your documents, aim for a voice and tone that's conversational, friendly, and respectful without being overly colloquial or frivolous; a voice that's casual and natural and approachable, not pedantic or pushy. Try to sound like a knowledgeable friend who understands what the developer wants to do. + - Use active voice: - Active: Grafana displays the heatmap visualization. - Passive: The heatmap visualization is displayed.