Skip to content

Graphql examples changes#295

Merged
mickhansen merged 6 commits intomasterfrom
graphql-examples-changes
Feb 24, 2026
Merged

Graphql examples changes#295
mickhansen merged 6 commits intomasterfrom
graphql-examples-changes

Conversation

@mickhansen
Copy link
Collaborator

No description provided.

It could confuse individuals who miss the dropdown
for SDK selection.
In case the developer refreshes the page or opens a new
link, it is beneficial to remember his choice.
For those developers just wanting to see an example
rather than interactively try it out.
@mickhansen mickhansen requested review from haysch and sgryt February 20, 2026 13:23
@netlify
Copy link

netlify bot commented Feb 20, 2026

Deploy Preview for criipto-docs failed.

Name Link
🔨 Latest commit 326513d
🔍 Latest deploy log https://app.netlify.com/projects/criipto-docs/deploys/69986063c942f200082b7276

@netlify
Copy link

netlify bot commented Feb 20, 2026

Deploy Preview for criipto-docs ready!

Name Link
🔨 Latest commit f99285e
🔍 Latest deploy log https://app.netlify.com/projects/criipto-docs/deploys/699d74567f913b0008435a99
😎 Deploy Preview https://deploy-preview-295--criipto-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Not available in SSR scenarios so we should make sure
they are nullable.
@mickhansen mickhansen force-pushed the graphql-examples-changes branch from 9ef4a85 to 453039f Compare February 20, 2026 13:50
@sgryt
Copy link
Contributor

sgryt commented Feb 20, 2026

The "Include signature information" seems to be acting up (not respecting the selected language)

image

@sgryt
Copy link
Contributor

sgryt commented Feb 20, 2026

Dropdown with lang-select is also missing
image

@haysch
Copy link
Contributor

haysch commented Feb 20, 2026

Dropdown with lang-select is also missing image

same goes for "Sign as a signatory"

image

@sgryt
Copy link
Contributor

sgryt commented Feb 20, 2026

Maybe because there are no explicit examples for these (in other langs), and then the docs do not explicitly select the version chosen on one of the other examples (or as set by the Skip link) ?

@sgryt
Copy link
Contributor

sgryt commented Feb 20, 2026

Maybe we should always have 2 options in the dropdown: "Raw" GQL (unauthenticated), and then "Live GQL" ?
Would always make it possible to swap between the 2, no matter how many other-lang examples we have available ?

@sgryt
Copy link
Contributor

sgryt commented Feb 20, 2026

same goes for "Sign as a signatory"

image

This seems to be off - should the 'MUST be' have been boldface ?
image

@mickhansen
Copy link
Collaborator Author

Maybe we should always have 2 options in the dropdown: "Raw" GQL (unauthenticated), and then "Live GQL" ? Would always make it possible to swap between the 2, no matter how many other-lang examples we have available ?

@sgryt Good idea I think, will explore that approach.

@sgryt
Copy link
Contributor

sgryt commented Feb 20, 2026

Maybe we should always have 2 options in the dropdown: "Raw" GQL (unauthenticated), and then "Live GQL" ? Would always make it possible to swap between the 2, no matter how many other-lang examples we have available ?

@sgryt Good idea I think, will explore that approach.

"Raw" GQL would also be a good fallback for all examples not matching the selected choice

@mickhansen
Copy link
Collaborator Author

@haysch @sgryt PR updated

@sgryt
Copy link
Contributor

sgryt commented Feb 24, 2026

@haysch @sgryt PR updated

I had implicitly expected that if I select GraphQL and click "Skip" in one of the examples, my choice would apply to all examples, but that does not seem to be the case.
Is that intentional ?

@mickhansen
Copy link
Collaborator Author

mickhansen commented Feb 24, 2026

Is that intentional ?

@sgryt Hmm, it used to, will take another look.
Ah no, never has :D But will make it so.

Providing a better fallback if an example is not available in a specific language.
@mickhansen
Copy link
Collaborator Author

@sgryt Should work like that now

@haysch
Copy link
Contributor

haysch commented Feb 24, 2026

@mickhansen it does seem like the "Sign acting as" and "Include signature information" (as part of the closeSignatureOrder) does not adhere to the common definition where there is an implementation in each of the language as pointed out by @sgryt.
It does break the immersion. It does not relate directly to the change being made here, but it might be good to have it changed before/as part of, maybe? I can do that in separate PR, if you have other things to do.

@mickhansen
Copy link
Collaborator Author

@mickhansen it does seem like the "Sign acting as" and "Include signature information" (as part of the closeSignatureOrder) does not adhere to the common definition where there is an implementation in each of the language as pointed out by @sgryt. It does break the immersion. It does not relate directly to the change being made here, but it might be good to have it changed before/as part of, maybe? I can do that in separate PR, if you have other things to do.

@haysch They have never had SDK examples. SDKs do not support signActingAs atm, and "Include signature information" is a liitle nonsensical.

I think it's out of scope of this PR in any case.

Copy link
Contributor

@haysch haysch left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Improvements LGTM.
The "Skip" option defaults to Raw GQL for all cases as expected, and the language selector works for all samples that have language options.
Haven't spotted other visual inconsistencies or issues.

@mickhansen mickhansen merged commit 842853e into master Feb 24, 2026
5 checks passed
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

Successfully merging this pull request may close these issues.

3 participants