Skip to content

docs: list the 2.x versions and refresh the generation notes - #117

Merged
ChiragAgg5k merged 1 commit into
mainfrom
chore/readme-current-versions
Sep 18, 2026
Merged

ChiragAgg5k merged 1 commit into
mainfrom
chore/readme-current-versions

Conversation

@ChiragAgg5k

Copy link
Copy Markdown
Member

The version table stopped at 1.9.x, so 2.0.x, 2.1.x and 2.2.x were published but undiscoverable from the README. All three have specs and examples in the repo.

Also:

  • The import example downloaded 2.0.x; it now uses 2.2.x, the current stable. The jq platform filter is unchanged, since 2.0.x and later all ship one document covering every platform.
  • The generation section used 1.9.x in its command and implied specs are produced by hand. Reworded to say releases run the task through deployment automation, which is why the PRs here come from a bot.
  • Added a note that each version is generated from the code that shipped it, so a document keeps the vendor extensions of its own release — x-appwrite.config appears from 2.2.x onwards, while earlier versions state the same binding with a ProjectPath security scheme.

Verified against the repo: examples/ has directories for 2.0.x, 2.1.x and 2.2.x, and specs/2.2.x holds open-api3-2.2.x.json. latest still has no examples, so its row keeps the dash.

@greptile-apps

greptile-apps Bot commented Sep 18, 2026

Copy link
Copy Markdown

RetriggerConfidence Score: 5/5

The PR appears safe to merge; the updated links, filenames, and release-specific metadata guidance align with the repository contents.

Summary

This documentation-only PR makes the existing 2.0.x through 2.2.x specifications and examples discoverable and refreshes usage and generation guidance.

  • Adds links for all three published 2.x releases.
  • Updates the OpenAPI download, filtering, and generation example to 2.2.x.
  • Clarifies automated generation and release-specific vendor-extension behavior.

Reviews (1) · Last reviewed commit: "docs: list the 2.x versions and refresh ..."

@ChiragAgg5k
ChiragAgg5k merged commit 7e01c16 into main Sep 18, 2026
2 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.

1 participant