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

feat(specs): improve consistency and naming #96

Merged
merged 5 commits into from
Jan 20, 2022

Conversation

shortcuts
Copy link
Member

@shortcuts shortcuts commented Jan 20, 2022

🧭 What and Why

🎟 JIRA Ticket: https://algolia.atlassian.net/browse/APIC-270

Changes included:

Aims at improving the naming and the specs consistency.

  • Rename Object suffix by Params, which was redundant in some cases, and also not always used.
  • Rename Record to Hit, Record is what is stored in Algolia, Hit is what is returned by the engine (additional properties).
  • Prevent using $refs from other definitions properties.
  • Rename Index to Indice, as having an index.EXTENSION file is usually used to define an entry point of a folder.
  • [JavaScript template]: Check for falsy values instead of null | undefined, as empty strings etc. are also wrong.

Open issue

Our wrapped types in JavaScript are suffixed by the word Props, which is really web-framework-react-vue-oriented, I did not find a better same yet, feel free to submit your ideas :D

🧪 Test

CI :D

@shortcuts shortcuts requested a review from a team January 20, 2022 09:29
@shortcuts shortcuts self-assigned this Jan 20, 2022
@shortcuts shortcuts requested review from eunjae-lee and removed request for a team January 20, 2022 09:29
Copy link
Collaborator

@millotp millotp left a comment

Choose a reason for hiding this comment

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

I like this

templates/javascript/api-single.mustache Outdated Show resolved Hide resolved
@shortcuts shortcuts requested a review from millotp January 20, 2022 15:12
@shortcuts shortcuts merged commit 5a6aa3b into main Jan 20, 2022
@shortcuts shortcuts deleted the fix/APIC-270/specs-consistency branch January 20, 2022 15:16
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