Ticket Created
over 3 years ago

WERETECH-9102

Please can the SDK documentation be more developer friendly and searchable and COMPLETE.

Hi,

COMPLETENESS

It is literally impossible to know what the actual limits are for some critical numbers that are easy to program around if and only if you know what the numbers are.

In particular, I have come up against these limits for FIT fields, but there are numerous other holes that need filling:

Specifically, for FIT fields, I believe you need to state somewhere 

  1. The total number of FIT fields that each device will allow 
    1. For any given activity, shared across all active DataField instances within all active data screens
    2. For any single DataField within an activity
    3. For any given App managing an activity
  2. The total number of CIQ fields that each individual device will support - eg: there is no point planning a suite of fields to satisfy broad display requirements if a device can only display two CIQ datafields

It would also be really useful to have, somewhere, a list of the lifecycle of events that occur for various features.

A recent one that caused me heartache was what actually happens on a device when a feature that isn't available on my watch to test against happens on the watch. If the events that would be fired to a DataField or App for each feature were listed, it would be easy to test around these.

SEARCHABILITY

The compatible devices page here: https://developer.garmin.com/connect-iq/compatible-devices/

Contains a wealth of good information. However, I only know that it contains a wealth of good information after sniffing out the JSON that feeds it and parsing it into a searchable Excel sheet.

With no offence intended to the person who designed it, the compatible devices page is utterly useless to somebody attempting to find out the specific devices that support or do not support any given feature, despite the fact that all of the information that we might need is in there.

If the compatible devices page were to include a search form to list out results, it would be transformed from a useless, gimmicky piece of marketing fluff into a potent and powerful developer resource.

PLEASE ADD SEARCHABILITY TO THE COMPATIBLE DEVICES PAGE.

G

9635560