Unifies instructions a bit, and improves grammar and wording

Author: hoijui

corne-cherry/doc/buildguide_en.md

@@ -1,8 +1,8 @@
 # Build Guide
 
 This is the Corne Cherry build guide.
-The build guide differs depending on the version,
+The build guide differs depending on the version of your board,
 so please choose your own from the following.
 
 - [v2 build guide](https://github.com/foostan/crkbd/blob/master/corne-cherry/doc/v2/buildguide_en.md)
-- [v3 build guide](https://github.com/foostan/crkbd/blob/master/corne-cherry/doc/v3/buildguide_en.md)
+- [v3 build guide](https://github.com/foostan/crkbd/blob/master/corne-cherry/doc/v3/buildguide_en.md)

corne-cherry/doc/v2/buildguide_en.md

@@ -1,7 +1,7 @@
 # Build Guide
 
 This is the build guide for Corne Cherry v2.
-[Corne Cherry v3 build guide](
+[Click here for the Corne Cherry v3 build guide](
 https://github.com/foostan/crkbd/blob/master/corne-cherry/doc/v3/buildguide_en.md).
 
 ## Parts
@@ -88,20 +88,21 @@ and you can concentrate on alignment and soldering.
 Also, if the soldering iron is too hot or the solder is touched too much,
 the flux contained in the solder may evaporate and form a clean pile of solder,
 but it can be repaired later,
-so at this point you should only be aware of attaching parts.
+so at this point you should only care about attaching parts.
 It's okay.
 
 ![06](https://user-images.githubusercontent.com/736191/54487436-79330280-48d9-11e9-856e-f3f5b9f58414.jpg)
 
 It is okay if the diode does not float when viewed from the side
 when one foot is attached.
-If it floats, press the diode with tweezers
-or your fingers and reheat the soldered part with a soldering iron to clean it.
+If it floats, press the diode with tweezers or your fingers
+and reheat the soldered part with a soldering iron to clean it.
 
 ![07](https://user-images.githubusercontent.com/736191/54487437-79330280-48d9-11e9-996d-a578e767c12c.jpg)
 
 Then solder the other one.
-Be careful not to apply too much as a small amount of solder is sufficient.
+Be careful not to apply too much,
+as a small amount of solder is sufficient.
 If you apply too much, you can remove it with a blotting wire
 or by scooping it with a soldering iron.
 
@@ -142,8 +143,8 @@ and then solder it with the back side of the Pro Micro facing up.
 ![11](https://user-images.githubusercontent.com/736191/54487441-79cb9900-48d9-11e9-9317-e77c4c408a4f.jpg)
 ![12](https://user-images.githubusercontent.com/736191/54487442-7a642f80-48d9-11e9-85f6-469d8beaa9c0.jpg)
 
-If you want to use the spring pin header,
-please refer to [Helix Build Guide](
+If you want to use spring-loaded pin headers,
+please refer to the [Helix Build Guide](
 https://github.com/MakotoKurauchi/helix/blob/master/Doc/buildguide_en.md#pro-micro).
 
 ### OLED module
@@ -164,10 +165,12 @@ It is recommended to check the operation when ProMicro and OLED module are attac
 To check the operation, first insert the firmware for crkbd into ProMicro
 by referring to the "Firmware" chapter below (be sure to insert it on both sides).
 
-To check the operation, connect the left hand side to the PC with MicroUSB
+To check the operation,
+connect the left hand side to the PC with MicroUSB,
 and connect the left hand side and the right hand side with the TRS cable.
 Since there may be defects such as jacks,
-be sure to connect the left and right instead of one by one before checking the operation.
+be sure to connect the left and right instead of one by one
+before checking the operation.
 If it is done correctly so far,
 if you short the pad to attach the PCB socket with tweezers etc.,
 the key pressed on the OLED module will be displayed.

corne-cherry/doc/v3/buildguide_en.md

@@ -1,7 +1,7 @@
 # Build Guide
 
 This is the build guide for Corne Cherry v3.
-[Click here for Corne Cherry v2](
+[Click here for the Corne Cherry v2 build guide](
 https://github.com/foostan/crkbd/blob/master/corne-cherry/doc/v2/buildguide_en.md).
 
 ## Parts
@@ -41,10 +41,10 @@ https://github.com/foostan/crkbd/blob/master/corne-cherry/doc/v2/buildguide_en.m
 ## Advance preparation
 
 If you build the firmware yourself,
-it takes time to prepare the environment,
-so it is recommended to start first. \
-See <https://github.com/foostan/crkbd/blob/master/doc/firmware_en.md>
-for more information.
+it will take some time to set up the environment,
+so it's best to start at the beginning. \
+For more information,
+please see <https://github.com/foostan/crkbd/blob/master/doc/firmware_en.md>.
 
 ## Verification
 
@@ -57,7 +57,8 @@ Make sure it is the same as your PCB.
 
 The PCB comes with a frame for manufacturing reasons.
 You can fold it by hand to remove it, but if it is difficult,
-make a cut in the joint \* with a cutter etc. to make it easier to remove.
+make a cut in the joint \* with a cutter or similar,
+to make it easier to remove.
 In addition, the joint can be cleaned with a file.
 
 \* *Joint part: There are a total of 8 parts,
@@ -74,7 +75,7 @@ Since SMD parts are very small,
 it is convenient to have tweezers and counter-acting tweezers.
 
 **The diode has a fixed mounting direction**,
-and solder it so that the "|" mark on the part faces the "|" on the diode mark "|◁".
+so solder it so that the "|" mark on the part faces the "|" on the diode mark "|◁".
 In addition, Corne's PCB has all the same diode mounting orientations.
 
 ![build_diode](assets/build_diode.jpg)
@@ -88,13 +89,14 @@ put the solder on only one side of the pad.
 ![tips_building_smd_01](https://user-images.githubusercontent.com/736191/54487435-79330280-48d9-11e9-9138-525d8ee68144.jpg)
 
 Next, solder one leg of the diode so that the spare solder melts.
-At this time, it is recommended to use reverse-action tweezers,
-because you can hold the chip parts firmly without exerting force
-and you can concentrate on alignment and soldering.
-Also, if the soldering iron is too hot or the solder is touched too much,
-the flux contained in the solder may evaporate and form a clean pile of solder,
-but it can be repaired later,
-so at this point you should only be aware of attaching parts.
+At this time,
+it is recommended to use [reverse-action tweezers](https://www.alimed.com/_resources/cache/images/product/70895A_850x480-pad.jpg),
+so that you can hold the SMD part firmly without applying force,
+and concentrate on alignment and soldering instead.
+Also, if the soldering iron is too hot or the solder is touched too long,
+the flux contained in the solder may evaporate and form an undesirable pile solder,
+but since it can be repaired later,
+so at this point you should only care about attaching parts.
 It's okay.
 
 ![tips_building_smd_02](https://user-images.githubusercontent.com/736191/54487436-79330280-48d9-11e9-856e-f3f5b9f58414.jpg)
@@ -106,13 +108,15 @@ and reheat the soldered part with a soldering iron to clean it.
 
 ![tips_building_smd_03](https://user-images.githubusercontent.com/736191/54487437-79330280-48d9-11e9-996d-a578e767c12c.jpg)
 
-Then solder the other one. Be careful not to apply too much,
-as a small amount of solder is sufficient.
-If you apply too much, you can remove it with a blotting wire
+Then solder the other pin.
+Be careful not to apply too much solder,
+as a small amount is sufficient.
+If you have applied too much,
+you can remove it with a suction pump, blotting wire
 or by scooping it with a soldering iron.
 
 If the amount of solder on the preliminary solder side is small,
-additional soldering is performed, and if it is a mountain,
+additional soldering is performed, and if it is a heap,
 apply flux from above and heat it to clean it.
 
 ![tips_building_smd_04](https://user-images.githubusercontent.com/736191/54487438-79cb9900-48d9-11e9-9280-dc72a2087307.jpg)
@@ -191,10 +195,11 @@ Solder ProMicro in the following orientation
 
 ![build_promicro](assets/build_promicro.jpg)
 
-If you use Conthru, you do not need to solder the back side.
-Please refer to [Helix Build Guide](
+If you use spring-loaded pin headers (e.g. Conthrough),
+you do not need to solder the back side.
+Please refer to the [Helix Build Guide](
 https://github.com/MakotoKurauchi/helix/blob/master/Doc/buildguide_en.md#pro-micro)
-for details on how to use Consul.
+for details on how to use spring-loaded pin headers.
 
 ![build_promicro_conthrough](assets/build_promicro_conthrough.jpg)
 
@@ -207,7 +212,7 @@ so be careful not to float it while pressing it with your finger.
 
 ![build_oled](assets/build_oled.jpg)
 
-## Firmware
+### Firmware
 
 Write the firmware to ProMicro by referring to the following. \
 <https://github.com/foostan/crkbd/blob/master/doc/firmware_en.md>
@@ -217,10 +222,12 @@ Write the firmware to ProMicro by referring to the following. \
 We recommend that you check the operation when the ProMicro and OLED module are attached.
 If you do it at the very end, it will be difficult to isolate the problem.
 
-To check the operation, connect the left hand side to the PC with MicroUSB,
+To check the operation,
+connect the left hand side to the PC with MicroUSB,
 and connect the left hand side and the right hand side with the TRRS cable.
 Since there may be defects such as jacks,
-be sure to connect the left and right instead of one by one before checking the operation.
+be sure to connect the left and right instead of one by one
+before checking the operation.
 If it is done correctly so far,
 if you short the pad to attach the PCB socket with tweezers etc.,
 the key pressed on the OLED module will be displayed.
@@ -242,7 +249,7 @@ The PCB socket is completed by soldering a total of 42 left and right.
 
 ### OLED protective plate
 
-Install the OLED protective plate with M2 9mm spacers and M2 screws.
+Attach the OLED protective plate with M2 9mm spacers and M2 screws.
 
 ![build_oled_plate_front](assets/build_oled_plate_front.jpg)
 ![build_oled_plate_back](assets/build_oled_plate_back.jpg)

corne-chocolate/doc/buildguide_en.md

@@ -1,7 +1,7 @@
 # Build Guide
 
 This is the build guide for Corne Chocolate.
-[Click here for Corne Cherry](
+[Click here for the Corne Cherry build guide](
 https://github.com/foostan/crkbd/blob/master/corne-cherry/doc/buildguide_en.md).
 
 ## Parts
@@ -82,21 +82,23 @@ First put solder only on the right side of the pad.
 
 Next, solder one of the diodes by melting the solder you already put on the board.
 At this time,
-it is recommended that you use inverted tweezers
+it is recommended to use [reverse-action tweezers](https://www.alimed.com/_resources/cache/images/product/70895A_850x480-pad.jpg),
 so that you can hold the SMD part firmly without applying force,
 and concentrate on alignment and soldering instead.
 Also, if the soldering iron is too hot or the solder is touched too long,
-the flux contained in the solder may evaporate and a solder pile may be formed,
+the flux contained in the solder may evaporate and form an undesirable pile solder,
 but since it can be repaired later,
-at this point just be aware of attaching parts;
+so at this point you should only care about attaching parts.
 It's okay.
 
 ![](https://user-images.githubusercontent.com/736191/52534541-320b9c00-2d86-11e9-982c-45ec7f7b7741.png)
 
 Then solder the other pin.
-Be careful not to apply too much solder because a small amount is sufficient.
+Be careful not to apply too much solder,
+as a small amount is sufficient.
 If you have applied too much,
-you can remove it with a suction pump or scoop it with a soldering iron.
+you can remove it with a suction pump, blotting wire
+or by scooping it with a soldering iron.
 
 ![](https://user-images.githubusercontent.com/736191/52534553-56677880-2d86-11e9-872e-ea374c8f6824.png)
 
@@ -140,8 +142,9 @@ and solder the Pro Micro with back side up.
 ![](https://user-images.githubusercontent.com/736191/52534641-a266ed00-2d87-11e9-8dcb-832b90556ac2.png)
 ![](https://user-images.githubusercontent.com/736191/52534643-aa269180-2d87-11e9-9c05-67924d235968.png)
 
-When using the spring pin header,
-please refer to the [Helix Build Guide](https://github.com/MakotoKurauchi/helix/blob/master/Doc/buildguide_en.md#pro-micro).
+When using the spring-loaded pin headers,
+please refer to the [Helix Build Guide](
+https://github.com/MakotoKurauchi/helix/blob/master/Doc/buildguide_en.md#pro-micro).
 
 ### OLED module
 

corne-classic/doc/buildguide_en.md

@@ -165,7 +165,8 @@ Two methods are introduced here.
 
 #### Using Spring Loaded Header
 
-Refer to [Helix Buildguide](https://github.com/MakotoKurauchi/helix/blob/master/Doc/buildguide_en.md#pro-micro)
+Refer to the [Helix build guide](
+https://github.com/MakotoKurauchi/helix/blob/master/Doc/buildguide_en.md#pro-micro)
 
 ProMicro kit with spring loaded headers is available at Yusha-Kobo
 

corne-light/doc/buildguide_en.md

@@ -1,7 +1,7 @@
 # Build Guide
 
 This is the Corne Light build guide.
-The build guide differs depending on the version,
+The build guide differs depending on the version of your board,
 so please choose your own from the following.
 
 - [v1 build guide](https://github.com/foostan/crkbd/blob/master/corne-light/doc/v1/buildguide_en.md)

corne-light/doc/v1/buildguide_en.md

@@ -1,6 +1,6 @@
 # Build Guide
 
-This is the Corne Light build guide.
+This is the Corne Light v1 build guide.
 
 ## Parts
 
@@ -113,7 +113,8 @@ This is the Corne Light build guide.
 If you build the firmware yourself,
 it takes time to prepare the environment,
 so it is recommended to start first. \
-See <https://github.com/foostan/crkbd/blob/master/doc/firmware_en.md> for more information.
+See <https://github.com/foostan/crkbd/blob/master/doc/firmware_en.md>
+for more information.
 
 ## Implementation
 
@@ -184,7 +185,7 @@ https://github.com/MakotoKurauchi/helix/blob/master/Doc/buildguide_en.md#pro-mic
 
 ![assembly-promicro-oled](https://user-images.githubusercontent.com/736191/69554644-6e427d00-0fe5-11ea-8c6b-9aaa3d2c3f6c.JPG)
 
-### Write firmware
+### Firmware
 
 Write the firmware to ProMicro by referring to the following. \
 <https://github.com/foostan/crkbd/blob/master/doc/firmware_en.md>
@@ -193,10 +194,10 @@ Write the firmware to ProMicro by referring to the following. \
 
 To check the operation,
 connect the left hand side to the PC with a USB cable,
-and connect the left hand side and the right hand side with a TRRS cable.
+and connect the left hand side and the right hand side with the TRRS cable.
 Since there may be defects such as jacks,
-be sure to connect the left and right
-instead of one by one before checking the operation.
+be sure to connect the left and right instead of one by one
+before checking the operation.
 
 * Since the switch is not attached,
   check the operation with tweezers as shown in the photo.

corne-light/doc/v2/buildguide_low_edition_en.md

@@ -105,7 +105,8 @@ and reheat the soldered part with a soldering iron to clean it.
 ![tips_building_smd_03](https://user-images.githubusercontent.com/736191/54487437-79330280-48d9-11e9-996d-a578e767c12c.jpg)
 
 Then solder the other one.
-Be careful not to apply too much, as a small amount of solder is sufficient.
+Be careful not to apply too much,
+as a small amount of solder is sufficient.
 If you apply too much, you can remove it with a blotting wire
 or by scooping it with a soldering iron.
 
@@ -138,10 +139,11 @@ Solder ProMicro in the following orientation
 
 ![build_promicro](assets/build_promicro.jpg)
 
-If you use Conthru, you do not need to solder the back side.
-Please refer to [Helix Build Guide](
+If you use spring-loaded pin headers (e.g. Conthrough),
+you do not need to solder the back side.
+Please refer to the [Helix Build Guide](
 https://github.com/MakotoKurauchi/helix/blob/master/Doc/buildguide_en.md#pro-micro)
-for details on how to use Consul.
+for details on how to use spring-loaded pin headers.
 
 ![build_promicro_conthrough](assets/build_promicro_conthrough.jpg)
 
@@ -164,7 +166,8 @@ Write the firmware to ProMicro by referring to the following. \
 We recommend that you check the operation when the ProMicro and OLED module are attached.
 If you do it at the very end, it will be difficult to isolate the problem.
 
-To check the operation, connect the left hand side to the PC with MicroUSB,
+To check the operation,
+connect the left hand side to the PC with MicroUSB,
 and connect the left hand side and the right hand side with the TRRS cable.
 Since there may be defects such as jacks,
 be sure to connect the left and right instead of one by one
@@ -183,7 +186,7 @@ so it is easier to attach only the end key switches first.
 
 ### OLED protective plate
 
-Attach his OLED protective plate with M2 9mm spacers and M2 screws.
+Attach the OLED protective plate with M2 9mm spacers and M2 screws.
 
 ![build_oled_plate_front](assets/build_oled_plate_front.jpg)
 ![build_oled_plate_back](assets/build_oled_plate_back.jpg)