Address Sorixelle's comments

Signed-off-by: C-D-Lewis <[email protected]>

Author: C-D-Lewis

source/tutorials/js-watchface-tutorial/part1.md

@@ -276,6 +276,9 @@ ctx.stroke();
 This is the complete code assembled so far, including a helpful function for
 drawing the hands and converting a time fraction to a Radian angle.
 
+<details>
+<summary>View watchface source code</summary>
+{% markdown %}
 ```js
 var rocky = require('rocky');
 
@@ -342,6 +345,9 @@ rocky.on('minutechange', function(event) {
   rocky.requestDraw();
 });
 ```
+{% endmarkdown %}
+</details>
+
 
 Now compile and run your project in the emulator to see the results!
 

source/tutorials/js-watchface-tutorial/part2.md

@@ -351,6 +351,9 @@ This is the complete code for this tutorial, separated by JS file. Compare it
 to yours if you have problems with any part of it or it is not working as
 expected.
 
+<details>
+<summary>View watchface source code</summary>
+{% markdown %}
 ```js
 // File: rocky/index.js
 
@@ -457,7 +460,12 @@ rocky.on('message', function(event) {
   }
 });
 ```
+{% endmarkdown %}
+</details>
 
+<details>
+<summary>View PKJS source code</summary>
+{% markdown %}
 ```js
 // File: pkjs/index.js
 
@@ -502,6 +510,8 @@ Pebble.on('message', function(event) {
   }
 });
 ```
+{% endmarkdown %}
+</details>
 
 
 ## Conclusion
@@ -528,3 +538,7 @@ provided above.
 
 We hope you enjoyed this tutorial and that it inspires you to make something
 awesome!
+
+Why not let us know what you've created on Fediverse
+[@rebble](https://mastodon.social/@rebble), or join our epic developer
+community on [Discord]({{ site.links.discord_invite }}).

source/tutorials/watchface-tutorial/part1.md

@@ -83,9 +83,9 @@ Now we can start to write some code!
 
 Our first source file is already created for you by the `pebble` command
 line tool and lives in the project's `src` directory. By default, this file
-contains sample code which you can safely remove completely, since we will be
-starting from scratch. Alternatively, you can avoid this by using the `--simple`
-flag when creating the project.
+contains sample code which you can safely remove, since we will be starting from
+scratch. Alternatively, you can avoid this by using the `--simple` flag when
+creating the project.
 
 Let's add the basic code segments which are required by every watchapp. The
 first of these is the main directive to use the Pebble SDK at the top of the
@@ -95,7 +95,7 @@ file like so:
 #include <pebble.h>
 ```
 
-After this first line, we should begin with the recommended app structure,
+After this first line, we begin with the recommended app structure,
 specifically a standard C `main()` function and two other functions to help us
 organize the creation and destruction of all the Pebble SDK elements. This helps
 make the task of managing memory allocation and deallocation as simple as

source/tutorials/watchface-tutorial/part2.md

@@ -54,7 +54,7 @@ done, you should end up with a watchface looking like this:
 
 To continue from the last part, you can either modify your existing Pebble
 project or create a new one, using the code from the end of the last tutorial
-as a starting point. Don't forget also to include changes to `package.json`.
+as a starting point. Don't forget to also include changes to `package.json`.
 
 The result of the first part should look something like this - a basic time
 display:
@@ -76,7 +76,7 @@ Let's improve it!
 
 App resources (fonts and images etc.) are managed in the `package.json`
 file in the project's root directory, as detailed in
-[*App Resources*](/guides/app-resources/). Below is an  example entry in the
+[*App Resources*](/guides/app-resources/). Below is an example entry in the
 `resources` section:
 
 ```json

source/tutorials/watchface-tutorial/part3.md

@@ -208,7 +208,7 @@ missed. The code snippet below shows this process using two variables to specify
 the inbox and outbox size (in bytes):
 
 ```c
-// Open AppMessage
+// Open AppMessage with some useful example buffer sizes
 const int inbox_size = 256;
 const int outbox_size = 128;
 app_message_open(inbox_size, outbox_size);
@@ -704,7 +704,7 @@ static void init() {
   app_message_register_outbox_failed(outbox_failed_callback);
   app_message_register_outbox_sent(outbox_sent_callback);
 
-  // Open AppMessage
+  // Open AppMessage with some useful example buffer sizes
   const int inbox_size = 256;
   const int outbox_size = 128;
   app_message_open(inbox_size, outbox_size);

source/tutorials/watchface-tutorial/part5.md

@@ -62,7 +62,7 @@ hidden when reconnected. Save the image below for use in this project:
 
 Add this icon to your project by copying the above icon image to the
 `/resources/images` project directory, and adding a new JSON object to the
-`media` array in `package.json` such as the following:
+`media` array in `package.json`:
 
 ```js
 {
@@ -138,8 +138,9 @@ twice. It may take a few seconds for the watch to register the disconnection.
 
 ## Conclusion
 
-Now our watchface shows the watch's remaining battery level! It's discreet,
-but very useful.
+Now our watchface shows the watch's connection status, which is useful if the
+user goes out of range of their phone or might want to be aware notifications
+might not come through when disconnected.
 
 As usual, you can compare your code to the example code provided below.