Skip to content

Conversation

@ClaraMuller
Copy link
Contributor

@ClaraMuller ClaraMuller commented Nov 18, 2025

🧭 What and Why

I saw that the final documentation of facets query parameter in Comp API in the documentation is not valid because we made an error in the specs:

Screenshot 2025-11-18 at 10 13 29

(the value in example is not valid) ⬆️

This PR aims to fix the examples

Changes included:

  • Update of specs for Composition API

🧪 Test

  • CI
  • Run locally yarn cli build specs all && yarn cli build clients javascript

@ClaraMuller ClaraMuller requested a review from a team November 18, 2025 09:14
@ClaraMuller ClaraMuller requested a review from a team as a code owner November 18, 2025 09:14
@algolia-bot
Copy link
Collaborator

algolia-bot commented Nov 18, 2025

✔️ Code generated!

Name Link
🪓 Triggered by 6c21509d7b8f14b5acdec4708c4261ae57e39c8d
🍃 Generated commit 6965e47eed06dd336ec5ec62542505a58bf8e78d
🌲 Generated branch generated/clara/fix/facet-example
📊 Benchmark results

Benchmarks performed on the method using a mock server, the results might not reflect the real-world performance.

Language Req/s
javascript 2463
php 2267
go 2254
csharp 1525
python 1375
java 1206
ruby 923
swift 663
scala 23

Fluf22
Fluf22 previously approved these changes Nov 18, 2025
Copy link
Collaborator

@Fluf22 Fluf22 left a comment

Choose a reason for hiding this comment

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

Fluf22
Fluf22 previously approved these changes Nov 18, 2025
Copy link
Collaborator

@Fluf22 Fluf22 left a comment

Choose a reason for hiding this comment

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

Ah yes apparently it must be an object, not a list
Let's see if it works this way

@ClaraMuller
Copy link
Contributor Author

@Fluf22 unclear what is expected, documentation (https://swagger.io/docs/specification/v3_0/adding-examples/) asks for an object, but the lint specs failed because it expects an iterator it seems ?

@ClaraMuller
Copy link
Contributor Author

I had the same error locally (whereas my initial proposal)

Copy link
Collaborator

@Fluf22 Fluf22 left a comment

Choose a reason for hiding this comment

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

😅

@millotp millotp merged commit f7133c8 into main Nov 18, 2025
67 of 75 checks passed
@millotp millotp deleted the clara/fix/facet-example branch November 18, 2025 16:54
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.

6 participants