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

Updates the CHANGELOG to be more uniform and specific. #694

Merged
merged 6 commits into from
Aug 31, 2021
Merged

Conversation

Shaptic
Copy link
Contributor

@Shaptic Shaptic commented Aug 31, 2021

Note: I recommend previewing the file directly instead of looking at the diff.

Major edits include:

  • separating changes out of individual PRs
  • more lists for easier reading
  • being more specific about objects or fields that changed, e.g.
    • listing the exact effects that changed
    • specifying fields that have changed more explicitly, and
    • calling out specific endpoints that we've introduced alongside their call builders

Overall, it should be easier for developers to digest the cumulative changes.

One of my biggest take-aways from Google's technical writing course
was "use more lists." I've tried to incorporate that here, breaking
down changes into specific items.

Another big change was being more specific and precise with the
data structures in the SDK that have been updated. For example, we
now list the effects that changed directly, specify fields that
have changed more explicitly, and call out specific endpoints that
we've introduced and their respective call builders.
@Shaptic Shaptic added the amm label Aug 31, 2021
@Shaptic Shaptic self-assigned this Aug 31, 2021
Copy link
Contributor

@marcelosalloum marcelosalloum left a comment

Choose a reason for hiding this comment

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

Great improvement to the changelog 🎉 !

I dropped a couple of comments below ⬇️

CHANGELOG.md Outdated Show resolved Hide resolved
CHANGELOG.md Outdated
Comment on lines 72 to 86
- The `ChangeTrustOperationResponse` has changed ([#688](https://github.com/stellar/js-stellar-sdk/pull/688)):
* `asset_type` can now be `liquidity_pool_shares`
* `asset_code` and `asset_issuer` are now optional
* `liquidity_pool_id` is a new optional field

- The trustline effects (`TrustlineCreated`, `TrustlineUpdated`, `TrustlineRevoked`) have changed ([#690](https://github.com/stellar/js-stellar-sdk/pull/690)):
* the asset type can now be `liquidity_pool_shares`
* they can optionally include a `liquidity_pool_id`

- Trustline sponsorship effects (`TrustlineSponsorshipCreated`, `TrustlineSponsorshipUpdated`, `TrustlineSponsorshipRemoved`) have been updated ([#690](https://github.com/stellar/js-stellar-sdk/pull/690)):
* the `asset` field is now optional, and is replaced by
* the `liquidity_pool_id` field for liquidity pools

- The `ChangeTrustOperationResponse` has changed ([#692](https://github.com/stellar/js-stellar-sdk/pull/692)):
* the `trustee` field is now optional
Copy link
Contributor

Choose a reason for hiding this comment

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

💡 There are two items referring to ChangeTrustOperationResponse breaking changes here. We should group them into a single item.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Another excellent point 👍 done in 320ef43

@Shaptic Shaptic merged commit 9ec9ef3 into v9.0.0 Aug 31, 2021
@Shaptic Shaptic deleted the v9-readme branch August 31, 2021 22:02
Shaptic added a commit that referenced this pull request Sep 2, 2021
* Use stellar-base 6.0.1 from the npm registry.
* Correctly process transaction response for offers based on XDR changes (#681)
* Adds a basic call builder for the `/liquidity_pools` endpoint. (#682)
* Add call builder for liquidity pools, w/ filters by reserve asset
* Update TradesCallBuilder to accept the trade_type filter and support Liquidity Pool trades (#685)
* [CD/CI] Add GitHub Actions to run tests on PRs (#686)
* Support filtering accounts participating in a given LP and update accounts balance response (#688)
* Allow querying a single liquidity pool by its specific ID. (#687)
* Allow querying actions (ops, txs, fx) related to a specific liquidity pool. (#689)
* Add new effect types (#690)
* Refactors call builders to simplify referencing 'neighbor' endpoints (#691)
* Update with CAP-38 operations (#692)
* Simplifies an expression to be more readable (#695)
* Updates the CHANGELOG to be more uniform and specific. (#694)
* Fix how the ?reserves filter works on the /accounts endpoint (#698)
* Update more call builders to use the new helper API. (#699)
* Add integration tests against the real mock API server (#697)
* Prepares the v9.0.0 branch for merging into master (#701)
* Update Horizon API fields to reflect the coming post-AMM API (#702)

Co-authored-by: Marcelo Salloum dos Santos <marcelo@stellar.org>
Co-authored-by: George <Shaptic@users.noreply.github.com>
Co-authored-by: George Kudrayvtsev <george@stellar.org>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants