Updated all descriptions, copying from .h as needed.

See also: joeycastillo/Sensor-Watch#297

content/en/docs/watchfaces/clock.md

@@ -28,13 +28,46 @@ Binary LED Clock
 ----------------
 [`simple_clock_bin_led_face`](https://github.com/joeycastillo/Sensor-Watch/blob/main/movement/watch_faces/clock/simple_clock_bin_led_face.h)
 
-TODO
+A "fork" of the simple clock face, which provides the functionality of showing 
+the current time by flashing the LED using binary representation.
+
+This feature serves as a practical solution to compensate for the admittedly 
+subpar backlight of the F91w watch and is especially useful if your eyesight
+is not the best. By pressing and holding the light button long enough, the
+watch will illuminate the LED to showcase the current time.
+
+How to interpret the flashing led:
+- Firstly, the hour is presented as a binary number, with the lowest bit displayed
+  first. A short flash signifies 0, while a longer flash represents 1. If you use
+  the watch in 24h mode, please note that the indicated value may be decreased 
+  by 12, to keep things simple and short. For example, 22h would be translated
+  to 10h.
+- After showing the hour, a lengthier  pause indicates that minutes will be shown 
+  next.
+- Similar to the hour representation, minutes are displayed in binary format, 
+  starting with the lowest bits. A short flash denotes 0, a longer flash 
+  represents 1.
 
 Decimal Time
 ------------
 [`decimal_time_face`](https://github.com/joeycastillo/Sensor-Watch/blob/main/movement/watch_faces/clock/decimal_time_face.h)
 
-TODO
+This face presents the current time as hours and hundredths of an hour. Every hundreth of an hour, or "centihour", 
+occurs every 36 seconds. Because they range from 0 to 99, centihours, in the seventies range, will be displayed with a lowercase 7.
+
+See https://en.wikipedia.org/wiki/Decimal_time#Decimal_hours
+
+This method of timekeeping is used by the United States Postal Service.
+* http://www.branch38nalc.com/sitebuildercontent/sitebuilderfiles/CONVERSION_TABLE_TIME.pdf
+* https://postalemployeenetwork.com/time-conversion-print.htm
+
+This method may be used by other organizations as well
+* https://www.labor.nc.gov/workplace-rights/employer-responsibilities/time-conversion-chart-minutes-decimal-hours
+* https://uh.edu/office-of-finance/payroll/time_conversion_chart_minutes_to_decimalhours.pdf
+* https://www.placer.ca.gov/DocumentCenter/View/3860/Decimals-to-Minutes-Conversion-Table-PDF
+* https://hr.colostate.edu/minute-to-decimal-conversion-chart/
+
+Many thanks go to Joey Castillo for making this project happen.
 
 Mars Time
 ---------
@@ -62,7 +95,28 @@ Repetition Minute
 -----------------
 [`repetition_minute_face`](https://github.com/joeycastillo/Sensor-Watch/blob/main/movement/watch_faces/clock/repetition_minute_face.h)
 
-TODO
+A hopefully useful complication for friendly neighbors in the dark
+
+Originating from 1676 from reverend and mechanician Edward Barlow, and
+perfected in 1820 by neighbor Abraham Breguet, a minute repeater or 
+"repetition minute" is a complication in a mechanical watch or clock that
+chimes the hours and often minutes at the press of a button. There are many
+types of repeater, from the simple repeater which merely strikes the number
+of hours, to the minute repeater which chimes the time down to the minute,
+using separate tones for hours, quarter hours, and minutes. They originated
+before widespread artificial illumination, to allow the time to be determined
+in the dark, and were also used by the visually impaired. 
+
+How to use it :
+
+Long press the light button to get an auditive reading of the time like so :
+0..23 (1..12 if 24-hours format isn't enabled) low beep(s) for the hours
+0..3 low-high couple pitched beeps for the quarters
+0..14 high pitched beep(s) for the remaining minutes
+
+Prerequisite : a watch with a working buzzer
+
+~ Only in the darkness can you see the stars. - Martin Luther King ~
 
 Simple Clock
 ------------
@@ -78,7 +132,9 @@ Week Number Clock
 -----------------
 [`weeknumber_clock_face`](https://github.com/joeycastillo/Sensor-Watch/blob/main/movement/watch_faces/clock/weeknumber_clock_face.h)
 
-TODO
+Same as simple clock, but has iso 8601 week number instead of seconds counter.
+
+Long-press ALARM to toggle the hourly chime.
 
 World Clock
 -----------
@@ -94,11 +150,80 @@ World Clock 2
 -------------
 [`world_clock2_face`](https://github.com/joeycastillo/Sensor-Watch/blob/main/movement/watch_faces/clock/world_clock2_face.h)
 
-TODO
+This is an alternative world clock face that allows the user to cycle
+through a list of selected time zones. It extends the original
+implementation by Joey Castillo. The face has two modes: display mode
+and settings mode.
+
+Settings mode
+
+When the clock face is activated for the first time, it enters settings
+mode. Here, the user can select the time zones they want to display. The
+face shows a summary of the current time zone:
+ * The top of the face displays the first two letters of the time zone
+   abbreviation, such as "PS" for Pacific Standard Time or CE for
+   "Central European Time".
+ * The upper-right corner shows the index number of the time zone. This
+   helps avoid confusion when multiple time zones have the same two-letter
+   abbreviation.
+ * The main display shows the offset from UTC, with a "+" indicating a
+   positive offset and a "-" indicating a negative offset. For example,
+   the offset for Japanese Standard Time is displayed as "+9:00".
+
+The user can navigate through the time zones and select them using the
+following buttons:
+ * The ALARM button moves forward to the next time zone, while the LIGHT
+   button moves backward to the previous zone. This way, the user can
+   cycle through all 41 supported time zones.
+ * A long press on the LIGHT button selects the current time zone, and
+   the signal indicator appears at the top left. Another long press of
+   the LIGHT button deselects the time zone.
+ * A long press on the ALARM button exits settings mode and returns to
+   display mode.
+
+Display mode
+
+In the display mode, the face shows the time of the currently selected
+time zone. The face includes the following components:
+ * The top of the face displays the first two letters of the time zone
+   abbreviation, such as "PS" for Pacific Standard Time or "CE" for
+   Central European Time.
+ * The upper-right corner shows the current day of the month, which helps
+   indicate time zones that cross the international date line with respect
+   to the local time.
+ * The main display shows the time in the selected time zone in either
+   12-hour or 24-hour form. There is no timeout, allowing users to keep
+   the chosen time zone displayed for as long as they wish.
+
+The user can navigate through the selected time zones using the following
+buttons:
+ * The ALARM button moves to the next selected time zone, while the LIGHT
+   button moves to the previous zone. If no time zone is selected, the
+   face simply shows UTC.
+ * A long press on the ALARM button enters settings mode and enables the
+   user to re-configure the selected time zones.
+ * A long press on the LIGHT button activates the LED illumination of the
+   watch.
 
 Wyoscan
 -------
 [`wyoscan_face`](https://github.com/joeycastillo/Sensor-Watch/blob/main/movement/watch_faces/clock/wyoscan_face.h)
 
-TODO
+This is a recreation of the Wyoscan watch, which was a $175 watch in 2014.
+It was an f-91w pcb replacement.
+
+Video: https://user-images.githubusercontent.com/1795778/252550124-e07f0ed1-e328-4337-a654-fa1ee65d883f.mp4
+Background information: https://artmetropole.com/shop/11460
+Demo of what it looks like: https://www.o-r-g.com/apps/wyoscan
+
+8 frames per number * 6 numbers + the trailing 16 frames = 64 frames
+at 32 frames per second, this is a 2-second cycle time or 0.5 Hz.
+
+It is giving me a stack overflow after about 2.5 cycles of the time display
+in the emulator, but it works fine on the watch.
+
+I'd like to make something for the low energy mode, but I haven't thought
+about how that might work, right now it just freezes in low energy mode
+until you press the 12-24HR button.
 
+There are no controls; it simply animates as long as the page is active.