Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clarify that Context types are defined in JSON and may be handled differently in specific API bindings #1486

Open
Tracked by #1499
kriswest opened this issue Jan 7, 2025 · 0 comments
Labels
Context Data & Intents Contexts & Intents Discussion Group docs Documentation

Comments

@kriswest
Copy link
Contributor

kriswest commented Jan 7, 2025

Enhancement Request

As identified in the discussion on #1479, the Context Part of the FDC3 standard defines the JSON encoding of Context objects, which is (in JS and .NET so far) translated into a set of types defined for that language, which may change the type of specific fields to an idiomatic type for that language (for example Date fields in JSON are string encoded according to ISO 8601-1:2019, while in JavaScript/TypeScript the Date type is used, which stringifies to the same format).

The Context overview should:

  • include content explaining the difference between the JSON definitions and definitions for a specific languages API binding.
  • include language-specific details on field type conventions (if they differ by language binding - e.g. dates and times).
  • link to source code and packages for language-specific bindings for context types.

@hellosmithy @bingenito @kemerava

@kriswest kriswest added docs Documentation Context Data & Intents Contexts & Intents Discussion Group labels Jan 7, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Context Data & Intents Contexts & Intents Discussion Group docs Documentation
Projects
None yet
Development

No branches or pull requests

1 participant