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

General questions about the project #10

Open
hmil opened this issue Aug 17, 2021 · 0 comments
Open

General questions about the project #10

hmil opened this issue Aug 17, 2021 · 0 comments

Comments

@hmil
Copy link

hmil commented Aug 17, 2021

Hi there,

I found this project while researching lightweight alternatives to OpenAPI. All I want to do is add a little bit of safety to my APIs, and I found that OpenAPI is way overkill for my use case, too complex, poorly documented and with impractical codegen tools.

Therefore, JTD seems like a better starting point to just generate portable DTOs.

Looks like the project is barely getting started though, and I've got a few questions in my mind:

  • How is JTD different from JSON-schema? On the surface, there seems to be a lot of overlap. Both of them let you define the shape of structured data, perform validation and even codegen.
  • What other similar alternatives are you aware of, and how does JTD differentiate from them?
  • How is the project governance structured? I suppose right now it's mostly you @ucarion working on it on the side. Are you getting any kind of support? What are your plans for the future?
  • Why the .com extension? It makes the project look like it's a commercial product when in fact it is an open initiative. Would you consider switching to .org or similar?
  • Does the spec support / plan to support YAML as a first-class input encoding? It is nowadays generally accepted that YAML should be used for machine/human interfaces, and JSON for machine/machine interfaces. As far as I can tell, JTD's primary application is machine consumption of human-written specs. Hence yaml seems more suited for this application than JSON.

Looking forward to your answers.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant