(work in progress) Initial start of a v2.x OAS/Swagger.

[darrellodonnell]

initial v2 OAS/Swagger (work in progress)

[linux-foundation-easycla]

The committers listed above are authorized under a signed CLA.

• ✅ login: darrellodonnell / name: Darrell O'Donnell (7375e1a)

[andorsk]

@darrellodonnell this looks very similar to v1 specs ( which is fine ). Would that be mostly the current intent of this proposal, to port over v1 first and work with that as a starting point?

nit: Change the PR to Draft status ( it's a button on the "conversations" ) tab, to indicate you are not ready for full review.

[darrellodonnell]

The intent of this work is manifold. Two of the inputs are:

1. Maintain alignment with v1. The value of the v1 approach (answering 3 simple questions) has been helpful to date.
2. Explore the basic remaining questions that we tabled in the v1 work, where our data model needs fleshing out (e.g. how does one represent the laundry list of credential types, schema, roles in an EGF).

Swagger is helpful here (and I'll be using a Swagger (OAS) to PlantUML tooling for some early UML models that can be refined as logical models.

not: I changed the PR to draft. What does that mean? I want this code pushed in for sharing in the community ASAP.

[andorsk]

@darrellodonnell we can talk about the PR, but normally merging the PR into master means that it's accepted as the right thing to do, which requires review.

Since I wasn't sure if you were planning to iterate on this before review, I suggested moving it to draft status until it was ready to be merged in. If you think it's ready to merge, then you can click "ready for review" (above) and we can discuss in more detail during the next TRTF call

[darrellodonnell]

I am on PTO most of this week (other than today) and not likely to get the work done that I had hoped (mostly the creation of the diagrams and a .md file with an explainer). Let me see what I can do tonight.

…

On Mon, Jan 23, 2023 at 10:51 AM Andor Kesselman ***@***.***> wrote: @darrellodonnell <https://github.com/darrellodonnell> we can talk about the PR, but normally merging the PR into master means that it's accepted as the right thing to do, which requires review. Since I wasn't sure if you were planning to iterate on this before review, I suggested moving it to draft status until it was ready to be merged in. If you think it's ready to merge, then you can click "ready for review" (above) and we can discuss in more detail during the next TRTF call — Reply to this email directly, view it on GitHub <#60 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAFHWB3BULX7WZYHYZG37Z3WT3HKFANCNFSM6AAAAAAT4GEUYM> . You are receiving this because you were mentioned.Message ID: ***@***.***>

[andorsk]

Making this a little more accessible for those that don't understand how to read swagger docs:

Copy this file here in the editor.

graph TD
  subgraph Query
      direction LR
      Issuer
      Verifier
      TrustRegistry[Trust Registry]
      getofflinefile[Offline File]
  end
  subgraph Lookup
      direction LR
      DIDMethods[DID Methods]
      presentationrequests[Presentation Requests]
      credentialTypes[Credential Types]
      overlays[Overlays]
      resources[Resources]
end

Loading