AcademySoftwareFoundation / AcademySoftwareFoundation/OpenTimelineIO

`null` semantics in JSON serialization

Open
#726 22 comments 0 reactions 0 assignees View on GitHub
Dominant language
C++
Stars
2k
Forks
351
Avg merge
1d 12h
Merged PRs (30d)
1

Description

In the JSON serialization, is there an intended difference in semantics between:
* the absence of a property
* the property set to `null`?
* in the case of objects/arrays, empty objects or arrays?

As a corollary, can all optional properties be set to `null`, or only some of them?

Contributor guide

Open the contributing guide

Research direction

No file, test, or entry point is named. First compare current JSON serialization behavior with existing OpenTimelineIO format documentation and examples, then resolve and document the semantics of absent, null, and empty object or array values, including which optional properties may be null.

Written by the indexing model from the issue text.

Assessment

Tech stack
cpp, json
Domain
backend-api-design, documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.