Skip to content

Conversation

mzrinsky
Copy link
Contributor

Just trying to pitch in on the documentation update and make things current.
This should be everything I had to do recently to get a new watch face working?

Any feedback is appreciated.

bmsleight and others added 6 commits August 28, 2022 10:59
…k-face

Updating documentation branch with latest release.
Helping to update the docs for adding new watch faces.
The process has changed a lot it seems.
These instructions should be current to the 1.15.0 release.
@mzrinsky
Copy link
Contributor Author

This is a continuation of the work that was done here.. #1302

@mark9064 mark9064 added the documentation Improvements or additions to documentation label Mar 24, 2025
Copy link
Contributor

@NeroBurner NeroBurner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the comprehensive writeup!

 - Clarify wording in a few places.
 - Remove file from list that is no longer edited.
 - Update usage of git checkout to git swtich
 - Add section with sed replace commands for new watch face.
 - Remove section that is now handled by sed replacements.
 - Remove extra newlines.
@mzrinsky
Copy link
Contributor Author

Thank you for the feedback!
I think I have addressed everything with this latest commit, I agree with all of it so I just went ahead and made the changes.


### Amend Files

Use sed to update `WatchFaceDigital` in the newly copied files with `WatchFaceNew` as well as update the `WatchFace::Digital` type to `WatchFace::NewType`.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No need to be imply this requires sed. You can tell the reader to copy the files and replace the text and then show the sed as a suggestion. Some people will want to do that in their editor or honestly not know the Unix tooling. (yeah, I know, but not everyone loves the terminal like us ....)


## Amending the Watch Face to Suit

Start editing and ammended WatchFaceNew.cpp to suit your tastes. To save space on the firmware, use existing fonts.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Start editing and ammended WatchFaceNew.cpp to suit your tastes. To save space on the firmware, use existing fonts.
Start editing WatchFaceNew.cpp to suit your tastes. To save space on the firmware, use existing fonts.

No need to talk about amending here. Editing covers all of the needed work.


If you already have a `build/CMakeCache.txt` it will prevent your new watch face from being included in the build, so you will need to pass the `--fresh` argument to `cmake` or remove `build/CMakeCache.txt` before building. (The value of DEFAULT_WATCHFACE_TYPES is cached.)

## Amending the Watch Face to Suit
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## Amending the Watch Face to Suit
## Editing the Watch Face to Suit

Copy link

@shaleh shaleh left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a good refresh. Perhaps it makes sense to pull in documentation about what the required methods do?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants