Update tutorials #45

C-D-Lewis · 2025-08-14T14:37:28Z

Goes some way to fixing #44 by testing creating projects from the snippets, and fixing dead links and small errors in code.

Also includes full source-code files as an expandable at the end instead of relying on a third-party Gist.

Fix way outdated mobile nav
C tutorial
JS tutorial
~~Advanced tutorials?~~ Requires missing example files (PDC SVG Zip file)

C-D-Lewis · 2025-08-15T08:43:44Z

@Sorixelle Seems GitHub's auto-merge main feature doesn't add the signed off by. Is that still an issue?

C-D-Lewis · 2025-08-18T18:45:51Z

@Sorixelle De-scoping the "Advanced Tutorials" section that contains only the PDC tutorial because it requires some files that I can't find anymore - broken link to the Pebble S3. It can be done in a follow-up PR.

Sorixelle · 2025-08-31T13:02:10Z

Seems GitHub's auto-merge main feature doesn't add the signed off by. Is that still an issue?

It is annoying but the checks don't like it, yeah. Generally, prefer rebases over merging to update a branch - it doesn't create an extra commit.

Sorry it's taken me so long to get to this one - gotta find time to properly look through the changes.

C-D-Lewis · 2025-08-31T13:54:10Z

Seems GitHub's auto-merge main feature doesn't add the signed off by. Is that still an issue?

It is annoying but the checks don't like it, yeah. Generally, prefer rebases over merging to update a branch - it doesn't create an extra commit.

Sorry it's taken me so long to get to this one - gotta find time to properly look through the changes.

Gotcha, I'll update it soon. Thanks for your review! No problem 😄

C-D-Lewis · 2025-09-01T11:15:19Z

@Sorixelle Things seem happier now!

Signed-off-by: C-D-Lewis <Bonsitm@gmail.com>

C-D-Lewis · 2025-10-12T14:58:04Z

@Sorixelle Fixed lint error! Good to merge now I think!

Sorixelle

Whew, sorry for taking so, so long to get around to this one. It's looking good, and I'm not fundamentally opposed to the changes. There's a few bits that need some cleanup though, I've left a handful of comments.

Sorixelle · 2025-10-13T10:22:54Z

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

 services.

 In this tutorial, we will interface with
 [Open Weather Map](http://openweathermap.org/) – a common weather API used by


note for future: rewrite to use OpenMeteo maybe? removes api key management requirment

That would be a good thing to do, but for me at least it's out of scope of this housekeeping/fixes PR.

Sorixelle · 2025-10-13T10:25:12Z

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

 If you have problems with your code, check it against the sample source code
-provided using the button below.
-
-[View Source Code >{center,bg-lightblue,fg-white}](https://github.com/pebble-examples/rocky-watchface-tutorial-part2)


Any reason for removing this link? It still seems to work.

I think now the entire source is in this page (easier to keep updated with the snippets leading to the full result, and easier for readers to compare) having some other entire copy to maintain is a burden we can do without. I felt similarly back in the day too.

Fair enough. I was thinking of getting the tutorial watchface repos under this org anyway - maybe we can have both once that happens

Sorixelle · 2025-10-13T10:27:29Z

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

-
-Why not let us know what you've created by tweeting
-[@pebbledev](https://twitter.com/pebbledev), or join our epic developer
-community on [Discord]({{ site.links.discord_invite }}).


I think we can keep the Discord link here - maybe replace the Twitter link with the Fediverse page?

Sorixelle · 2025-10-13T10:28:49Z

source/tutorials/watchface-tutorial/part1.md


 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, since we will be starting from


nit: unconvinced this is a necessary change

Sorixelle · 2025-10-13T10:30:47Z

source/tutorials/watchface-tutorial/part1.md

 #include <pebble.h>
 ```

-After this first line, we must begin with the recommended app structure,


I guess it's not strictly "must", but I'm not sure "should" is best here either. Maybe just drop the word entirely and go "we begin with..."?

Sorixelle · 2025-10-13T10:34:20Z

source/tutorials/watchface-tutorial/part2.md

-as a starting template. For reference, that should look
-[something like this](https://gist.github.com/pebble-gists/9b9d50b990d742a3ae34).
+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`.


Suggested change

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`.

I feel like using the GitHub UI to resolve this is a trap for making the linter angry, so will do it on my end.

Sorixelle · 2025-10-13T10:37:22Z

source/tutorials/watchface-tutorial/part2.md

-[*App Resources*](/guides/app-resources/). All image files and fonts must 
-reside in subfolders of the `/resources` folder of your project. Below is an 
-example entry in the `media` array:
+[*App Resources*](/guides/app-resources/). Below is an  example entry in the


Suggested change

[*App Resources*](/guides/app-resources/). Below is an example entry in the

[*App Resources*](/guides/app-resources/). Below is an example entry in the

Sorixelle · 2025-10-13T10:39:22Z

source/tutorials/watchface-tutorial/part3.md

 ```c
 // Open AppMessage
-const int inbox_size = 128;
+const int inbox_size = 256;


Is this a necessary code change?

My thinking was that this was a sensible value for someone who went from no settings to some medium length string or complex settings object and might be caught out later when it stops working. I'll update the comment for the value to explain.

Sorixelle · 2025-10-13T10:43:54Z

source/tutorials/watchface-tutorial/part5.md

-`package.json` such as the following:
+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:


Suggested change

`media` array in `package.json` such as the following:

`media` array in `package.json`:

Sorixelle · 2025-10-13T10:45:13Z

source/tutorials/watchface-tutorial/part5.md

+## Conclusion
+
+Now our watchface shows the watch's remaining battery level! It's discreet,
+but very useful.


This looks like the summary for the part 4, should change this to match part 5

Good catch 🦅 👁️

Signed-off-by: C-D-Lewis <bonsitm@gmail.com>

C-D-Lewis · 2025-10-13T20:05:34Z

@Sorixelle Addressed the suggested changes or otherwise left comments in response. Please take a look again when able!

Signed-off-by: C-D-Lewis <bonsitm@gmail.com>

C-D-Lewis · 2025-10-16T18:06:58Z

@Sorixelle Ready to land! Thanks for looking at this one :)

C-D-Lewis force-pushed the update-tutorials branch from 54e0837 to 2443388 Compare September 1, 2025 10:19

Update tutorials

b45f2cf

Signed-off-by: C-D-Lewis <Bonsitm@gmail.com>

C-D-Lewis force-pushed the update-tutorials branch from 60bb24e to b45f2cf Compare October 12, 2025 14:56

Sorixelle requested changes Oct 13, 2025

View reviewed changes

Address Sorixelle's comments

aac7945

Signed-off-by: C-D-Lewis <bonsitm@gmail.com>

Final PR comment addressed

2e0717b

Signed-off-by: C-D-Lewis <bonsitm@gmail.com>

	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`.

	[App Resources](/guides/app-resources/). Below is an example entry in the
	[App Resources](/guides/app-resources/). Below is an example entry in the

	`media` array in `package.json` such as the following:
	`media` array in `package.json`:

Update tutorials #45

Are you sure you want to change the base?

Update tutorials #45

Uh oh!

Conversation

C-D-Lewis commented Aug 14, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

C-D-Lewis commented Aug 15, 2025

Uh oh!

C-D-Lewis commented Aug 18, 2025

Uh oh!

Sorixelle commented Aug 31, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

C-D-Lewis commented Aug 31, 2025

Uh oh!

C-D-Lewis commented Sep 1, 2025

Uh oh!

C-D-Lewis commented Oct 12, 2025

Uh oh!

Sorixelle left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

C-D-Lewis commented Oct 13, 2025

Uh oh!

C-D-Lewis commented Oct 16, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

C-D-Lewis commented Aug 14, 2025 •

edited

Loading

Sorixelle commented Aug 31, 2025 •

edited

Loading