Rename schema DevicePPID to use PascalCase

[eric-murray]

What type of PR is this?

• correction

What this PR does / why we need it:

Rename schema DevicePPID to use PascalCase and avoid CAMARA validation error

Which issue(s) this PR fixes:

Fixes #180

Special notes for reviewers:

None

Changelog input

 release-note
 - Rename schema DevicePPID to use PascalCase

Additional documentation

None

[hdamker]

@eric-murray 😂

To say it with the words of Claude (asked to review the PR), but my first thought was the same:

DevicePeePeeIyeDee is the phonetic spelling of P-P-I-D ("Pee-Pee-Eye-Dee"). It technically satisfies the PascalCase rule (hence the green Validation run), but it's unreadable and discards the recognizable PPID acronym. This reads as malicious-compliance / a joke rather than a real fix — it should not merge as-is.

CAMARA's established convention is to treat an acronym as a word — capitalize only the first letter. Precedent across the API set is unambiguous:

• Id (not ID), Uri (not URI), WebhookUrl (not WebhookURL), AppId, SessionId, …

So the correct target is DevicePpid — it passes the same PascalCase check, stays readable, and keeps the acronym recognizable. The PPID meaning is already preserved in the schema description ("expressed as a PPID (Pairwise Pseudonymous Identifier)"), so no semantic loss either way.

[hdamker]

See comment

[hdamker]

Suggested change

	- $ref: "#/components/schemas/DevicePeePeeIyeDee"
	- $ref: "#/components/schemas/DevicePpid"

[hdamker]

Suggested change

	DevicePeePeeIyeDee:
	DevicePpid:

[Kevsy]

HI @hdamker - that makes sense, but just to note the convention/precedent is not documented (or at least, I can't find it :))

From API Design Guide:

Camel Case | It is a kind of define _(sic)_ the fields’ compound name or phrases without whitespaces among words (_sic_). It uses a capital letter at the beginning of each word. There are two different uses:
UpperCamelCase: When the first letter of each word is capital.
lowerCamelCase: Same to (_sic_) that Upper one, but with the first word in lowercase.

I'm happy to raise an issue to clarify the established convention (and correct the grammar noted by (sic) above)

[hdamker]

I'm happy to raise an issue to clarify the established convention (and correct the grammar noted by (sic) above)

That would make sense. Currently the convention is defined only by case law :-)