* docs: improve English naturalness in API v2 documentation
- Fix awkward API summary 'Find out when is an event type ready to be booked' to 'Get available time slots for an event type'
- Correct 'setup' vs 'set up' usage throughout documentation
- Fix OAuth capitalization consistency
- Improve 'api' to 'API' capitalization in v2 docs
- Enhance readability while preserving technical accuracy
Fixes unnatural English phrasing in titles, headers, descriptions, and summaries across API v2 documentation files.
Co-Authored-By: keith@cal.com <keithwillcode@gmail.com>
* docs: add missing articles 'the' in API v2 documentation
- Fix 'How to Set Up API' to 'How to Set Up the API' in titles
- Add 'the' before 'API' in descriptions and summaries
- Fix grammar error 'all you need to is' to 'all you need to do is'
- Improve naturalness while maintaining technical accuracy
Co-Authored-By: keith@cal.com <keithwillcode@gmail.com>
* docs: fix unnatural English in API v2 @ApiOperation summaries
- Fix grammatically incorrect 'conferencing apps oauths callback' to 'Conferencing app OAuth callback'
- Replace 'ooo' with 'out-of-office' in user-facing summaries for clarity
- Ensure consistent sentence case capitalization (only first letter capitalized)
- Remove trailing periods from summaries for consistency
- Fix awkward phrasing like 'Get by attribute id all of...' to more natural English
- Revert 'Introduction to the API v2' back to 'Introduction to API v2'
- Improve naturalness while maintaining technical accuracy
Co-Authored-By: keith@cal.com <keithwillcode@gmail.com>
* Update apps/api/v2/src/modules/slots/slots-2024-09-04/controllers/slots.controller.ts
* Update docs/api-reference/v2/openapi.json
* docs: fix setup/set up usage - use 'backend setup' (noun) not 'backend set up' (verb)
Co-Authored-By: keith@cal.com <keithwillcode@gmail.com>
* docs: fix setup/set up verb usage - use 'set up' (verb) not 'setup' (verb)
- Fix 'You have to setup' → 'You have to set up' in quickstart.mdx
- Fix 'Setup environment variables' → 'Set up environment variables'
- Fix 'Setup root of your app' → 'Set up root of your app'
- Fix 'prompted to setup' → 'prompted to set up' in setup.mdx
Co-Authored-By: keith@cal.com <keithwillcode@gmail.com>
* Ran v2 locally to regen the doc json files
---------
Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
* feat: Add Mintlify docs
* Fixed the mint.json for v2
* Fixed versioning issue
* Add titles to ICS feed endpoints
* Added errors to v1
* Added rate-limit to API v1
* feat: added v1-v2 differences and v1 auth
* Trying to eliminate reasons for v1 not showing on publication
* Used the swagger openapi validator
* remove deprecated v1 endpoints
* Moved api docs into new folders without api-reference
* Renamed api to api-reference
* removed the versioning
* Got rid of anchor warnings
* Fixed naming
* Just as a test - using the same v2 openapi spec for v1 reference
* Removed 'externalDocs' from v1
* Removed securitySchemes
* Updated the diff between v1/v2
* Added v1 in front of /attendees to test
* Moved paths up and removed externalDocs
* Testing - Added content to the response
* Reduced paths to 1
* Testing: anything at this point
* Fixed validation
* Moved the other .mdx files to see if that's disrupting something
* Trying with a tab
* Empty tags array
* Added back servers field
* Removed all other schemas
* Removed v1 for now
* Added platform docs
* Language fixes
* Added v1 back
* add API V1 response for attendees
* remove unnecessary endpoint docs in API V1
* Removing platform and API for now
* Updated v2 openapi doc
---------
Co-authored-by: Syed Ali Shahbaz <alishahbaz7@gmail.com>
