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

Add BREAKING.md updates from recent changes #7314

Merged
merged 5 commits into from
Aug 31, 2021

Conversation

skylerjokiel
Copy link
Contributor

Adding a collection of recent API breaking changes from the 3P space to Breaking.md.

@github-actions github-actions bot added the breaking change This PR or issue would introduce a breaking change label Aug 31, 2021
BREAKING.md Outdated
- [Anonymous return types for container calls in client packages](#Anonymous-return-types-for-container-calls-in-client-packages)
- [createContainer and getContainer response objects properties renamed](#createContainer-and-getContainer-response-objects-properties-renamed)
- [tinylicious and azure clients createContainer now detached](#tinylicious-and-azure-clients-createContainer-now-detached)
- [container id is returned from new attach() and not exposed on the container](#container-id-is-returned-from-new-attach()-and-not-exposed-on-the-container)
Copy link
Contributor

Choose a reason for hiding this comment

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

nit: this link doesn't seem to work, probably the () needs to be removed?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Hmm interesting. I actually checked this and it works in vscode. Removing them worked too so I did that but yea. Nice catch :)

BREAKING.md Outdated
@@ -14,6 +19,73 @@
- `FlushMode.Manual` to `FlushMode.TurnBased`
- `FlushMode.Automatic` to `FlushMode.Immediate`

### `name` removed from ContainerSchema
The `name` property on the ContainerSchema was used for multi-container scenarios but has not materialized to be a useful schema property. The feedback has been negative to neutral and the goal is to remove it before it becomes formalized. Support for multi-container scenarios, if any is required, will be addressed as a future change.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
The `name` property on the ContainerSchema was used for multi-container scenarios but has not materialized to be a useful schema property. The feedback has been negative to neutral and the goal is to remove it before it becomes formalized. Support for multi-container scenarios, if any is required, will be addressed as a future change.
The `name` property on the ContainerSchema was used for multi-container scenarios but has not materialized to be a useful schema property. The feedback has been negative to neutral so it is being removed before it becomes formalized. Support for multi-container scenarios, if any is required, will be addressed as a future change.

BREAKING.md Outdated
Comment on lines 57 to 61
// old
const { fluidContainer, containerServices } = client.getContainer;

// new
const { container, services } = client.getContainer;
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
// old
const { fluidContainer, containerServices } = client.getContainer;
// new
const { container, services } = client.getContainer;
// old
const { fluidContainer, containerServices } = client.getContainer(...);
// new
const { container, services } = client.getContainer(...);

nitty nitty

BREAKING.md Outdated
```

### container id is returned from new attach() and not exposed on the container
Because we now have an explicit attach flow the container id is apart of that flow. The id is returned from the `attach()` call.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Because we now have an explicit attach flow the container id is apart of that flow. The id is returned from the `attach()` call.
Because we now have an explicit attach flow, the container id is part of that flow as well. The id is returned from the `attach()` call.

@skylerjokiel skylerjokiel merged commit 1569180 into microsoft:main Aug 31, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
breaking change This PR or issue would introduce a breaking change
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants