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

Clarify firing of import_notification_stream in doc comment #5811

Merged
merged 11 commits into from
Sep 28, 2024

Conversation

ffarall
Copy link
Contributor

@ffarall ffarall commented Sep 24, 2024

Description

Updates the doc comment on the import_notification_stream to make its behaviour clearer.

Closes Unexpected behaviour of block import_notification_stream.

Integration

Doesn't apply.

Review Notes

The old comment docs caused some confusion to myself and some members of my team, on when this notification stream is triggered. This is reflected in the linked issue, and as discussed there, this PR aims to prevent this confusion in future devs looking to make use of this functionality.

Checklist

  • My PR includes a detailed description as outlined in the "Description" and its two subsections above.
  • My PR follows the labeling requirements of this project (at minimum one label for T required)
    • External contributors: ask maintainers to put the right label on your PR.
  • I have made corresponding changes to the documentation (if applicable)
  • I have added tests that prove my fix is effective or that my feature works (if applicable)

You can remove the "Checklist" section once all have been checked. Thank you for your contribution!

@bkchr bkchr added the T11-documentation This PR/Issue is related to documentation. label Sep 24, 2024
@bkchr bkchr requested a review from a team September 24, 2024 06:39
@bkchr
Copy link
Member

bkchr commented Sep 24, 2024

@ffarall could you please add a prdoc.

@ffarall
Copy link
Contributor Author

ffarall commented Sep 24, 2024

@bkchr prdoc added. I wasn't sure before if it was needed, given that it's a change in the comments only. But it's there now.

prdoc/pr_5811.prdoc Outdated Show resolved Hide resolved
prdoc/pr_5811.prdoc Outdated Show resolved Hide resolved
auto-merge was automatically disabled September 24, 2024 22:37

Head branch was pushed to by a user without write access

@bkchr bkchr added this pull request to the merge queue Sep 25, 2024
@github-merge-queue github-merge-queue bot removed this pull request from the merge queue due to failed status checks Sep 25, 2024
@bkchr bkchr added this pull request to the merge queue Sep 26, 2024
@github-merge-queue github-merge-queue bot removed this pull request from the merge queue due to failed status checks Sep 26, 2024
@bkchr bkchr added this pull request to the merge queue Sep 28, 2024
@github-merge-queue github-merge-queue bot removed this pull request from the merge queue due to failed status checks Sep 28, 2024
@bkchr bkchr added this pull request to the merge queue Sep 28, 2024
@github-merge-queue github-merge-queue bot removed this pull request from the merge queue due to failed status checks Sep 28, 2024
@bkchr bkchr merged commit df12fd3 into paritytech:master Sep 28, 2024
217 checks passed
paritytech-ci pushed a commit that referenced this pull request Oct 1, 2024
# Description

Updates the doc comment on the `import_notification_stream` to make its
behaviour clearer.

Closes [Unexpected behaviour of block
`import_notification_stream`](#5596).

## Integration

Doesn't apply.

## Review Notes

The old comment docs caused some confusion to myself and some members of
my team, on when this notification stream is triggered. This is
reflected in the linked
[issue](#5596), and as
discussed there, this PR aims to prevent this confusion in future devs
looking to make use of this functionality.

# Checklist

* [x] My PR includes a detailed description as outlined in the
"Description" and its two subsections above.
* [ ] My PR follows the [labeling requirements](

https://github.com/paritytech/polkadot-sdk/blob/master/docs/contributor/CONTRIBUTING.md#Process
) of this project (at minimum one label for `T` required)
* External contributors: ask maintainers to put the right label on your
PR.
* [x] I have made corresponding changes to the documentation (if
applicable)
* [x] I have added tests that prove my fix is effective or that my
feature works (if applicable)

You can remove the "Checklist" section once all have been checked. Thank
you for your contribution!

---------

Co-authored-by: Michal Kucharczyk <[email protected]>
Co-authored-by: Bastian Köcher <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
T11-documentation This PR/Issue is related to documentation.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Unexpected behaviour of block import_notification_stream
4 participants