From ef3f36789fa157523552017f5341d56c87eafdd7 Mon Sep 17 00:00:00 2001 From: Kersten Richter Date: Thu, 1 Aug 2024 16:41:49 -0500 Subject: [PATCH] Update writing.adoc spaces Signed-off-by: Kersten Richter --- src/writing.adoc | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/src/writing.adoc b/src/writing.adoc index 6370b4d..d784bf3 100644 --- a/src/writing.adoc +++ b/src/writing.adoc @@ -42,13 +42,13 @@ Use simple and direct language. Avoid using unnecessary phrases, such as saying |Yes |No -|To build a chip, +|To build a chip, |In order to build a chip, -|See the Hypervisor extension. +|See the Hypervisor extension. |Please see the Hypervisor extension. -|View the register. +|View the register. |With this next command, we'll view the register. |=== @@ -99,13 +99,12 @@ whether they're part of the "we" you're describing. |RISC-V provides a new feature for |We provide a new feature -|This page teaches you how to create CSRs. +|This page teaches you how to create CSRs. |In this page, we are going to learn about CSRs. |=== An exception for using "we" is the rationale sections. - === Avoid jargon and idioms Some readers speak English as a second language. Avoid jargon and idioms to help them understand better. @@ -159,10 +158,10 @@ Avoid words such as "just", "simply", "easy", "easily", or "simple". These words |Include one command in |Include just one command in -|Run the command +|Run the command |Simply run the command -|You can remove +|You can remove |You can easily remove |These steps