Skip to content

API naming conventions should be documented #536

@gibson042

Description

@gibson042

We should explicitly document naming conventions, and maintain them by evaluating new proposals against them.

  • Property names and values should avoid abbreviations.
    • Good examples: "fractionalSeconds", "minimumSignificantDigits"
  • Property names and values that are compound words should combine them using camelCase.
    • Good examples: "signDisplay", "exceptZero"
    • Exception: for values only, nonzero numbers should be expressed as digits (as in "h23")
    • Historical exceptions: "2-digit", "best fit"
  • [open question about "[...]style" vs. "[...]display" for naming high-level configuration properties]

Metadata

Metadata

Assignees

Labels

c: metaComponent: intl-wide issueseditorialInvolves an editorial fixs: help wantedStatus: help wanted; needs proposal champion

Type

No type

Projects

No projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions