Skip to content

docs: improve JSON and YAML example clarity #346#351

Open
Kah2412 wants to merge 1 commit intoaskimed:mainfrom
Kah2412:patch-1
Open

docs: improve JSON and YAML example clarity #346#351
Kah2412 wants to merge 1 commit intoaskimed:mainfrom
Kah2412:patch-1

Conversation

@Kah2412
Copy link

@Kah2412 Kah2412 commented Mar 11, 2026

Updated the generic 'key' and 'value' assertions in the JSON and YAML documentation to use more semantic terms like 'tool' and 'version'. This addresses the feedback in issue #346 to make the examples more intuitive for new users.

Updated the generic 'key' and 'value' assertions in the JSON and YAML documentation to use more semantic terms like 'tool' and 'version'. This addresses the feedback in issue askimed#346 to make the examples more intuitive for new users.
@nvnieuwk
Copy link
Collaborator

I don't think this makes it more clear that you can specify a key in the JSON file using this method. Could you maybe provide a small JSON object as an example and use this in the explanation?

@Kah2412
Copy link
Author

Kah2412 commented Mar 12, 2026

"Thanks for the feedback! I see your point. I will update the documentation to include a concrete JSON object example and show exactly how to reference a specific key from it. This should make the mapping logic much clearer for everyone. I'll push the changes shortly!

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.

2 participants