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

Improve pipeline model text description clarity #310

Merged
merged 1 commit into from
May 18, 2022

Conversation

wolenetz
Copy link
Member

@wolenetz wolenetz commented May 5, 2022

Fixes a typo (one of the flows was described incorrectly as going to a
Video Decoder, not an Audio Decoder), and fixes a couple omissions of
mentions of track buffer process indications between SourceBuffer 2
and Video Decoder, and between SourceBuffer 3 and Audio Decoder.

(I found these issues while investigating #307 and reviewing #308.)

Fixes a typo (one of the flows incorrectly was described as going to a
Video Decoder, not an Audio Decoder), and fixes a couple omissions of
mentions of track buffer process indications between SourceBuffer 2
Video Decoder, and between SourceBuffer 3 and Audio Decoder.
@wolenetz wolenetz requested review from tidoust and mwatson2 May 5, 2022 22:17
@wolenetz
Copy link
Member Author

wolenetz commented May 5, 2022

@mwatson2 - please review.

@tidoust - with #308 now merged to main, is there anything further needed to ensure both WD and ED have the updated text description once this PR is approved, squashed and merged to main?

@tidoust
Copy link
Member

tidoust commented May 9, 2022

@tidoust - with #308 now merged to main, is there anything further needed to ensure both WD and ED have the updated text description once this PR is approved, squashed and merged to main?

Well, there seems to be a bug somewhere that crashes the update of the gh-pages branch :( I don't yet know what triggers it, perhaps an incompatibility between the part of the job that handles the static content and the part of the job that handles the spec itself. I will look into it. No need to block any of the pending pull requests on this, I'll re-generate the gh-pages branch once I have found and fixed the bug!

@wolenetz
Copy link
Member Author

wolenetz commented May 9, 2022

I will look into it. No need to block any of the pending pull requests on this, I'll re-generate the gh-pages branch once I have found and fixed the bug!

Thank you. I'll await @mwatson2 review of this and eventually gh-pages will be right again :)

@wolenetz
Copy link
Member Author

@mwatson2 - please review this when you can. To clear the editorial PR backlog, I'm going to squash and merge this today though since it is indeed editorial.

@wolenetz wolenetz merged commit 3982135 into w3c:main May 18, 2022
@wolenetz wolenetz deleted the fix_pipeline_model_typos branch May 18, 2022 21:04

<p>This Track Buffer then flows to a green box labeled Audio Decoder, which
then flows through a closed switch, which then also continues to the same
indicator (green circle with an X) labeled Audio Device previously mentioned in
Copy link
Member

Choose a reason for hiding this comment

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

I think we could rephrase this to describe the purpose of "indicator (green circle with an X)". In a flow chart (I just looked this up...) the symbol is a "summing junction" which suggests that any enabled audio tracks are summed, i.e., mixed to form the output audio. This corresponds with definition of AudioTrack.

Unless you prefer to do it, I could raise a PR with suggested text along those lines.

Copy link
Member Author

Choose a reason for hiding this comment

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

Good catch. PR sounds good to me if you have time. I've filed an issue to ensure this gets done one way or the other :)
#314

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.

3 participants