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

WebAssembly 2021 chapter #2563

Merged
merged 37 commits into from
Nov 25, 2021
Merged

WebAssembly 2021 chapter #2563

merged 37 commits into from
Nov 25, 2021

Conversation

RReverser
Copy link
Member

@RReverser RReverser commented Nov 18, 2021

@rviscomi rviscomi added the writing Related to wording and content label Nov 18, 2021
@rviscomi rviscomi added this to the 2021 Content Writing milestone Nov 18, 2021
@rviscomi rviscomi changed the title WIP WebAssembly chapter WebAssembly 2021 chapter Nov 18, 2021
@tunetheweb
Copy link
Member

Turned it on in config and staged it here: https://20211118t191759-dot-webalmanac.uk.r.appspot.com/en/2021/webassembly (link added to first comment). @rviscomi or I can update this URL with the latest periodically.

@rviscomi
Copy link
Member

@RReverser is also running the site locally so it's less critical that we stage it for the author's benefit.

@tunetheweb
Copy link
Member

Ah Ok wasn’t sure if he was as config wasn’t set. Plus was nosy myself to have a look 😁

@RReverser
Copy link
Member Author

Ah Ok wasn’t sure if he was as config wasn’t set. Plus was nosy myself to have a look 😁

Ah thanks, yeah I didn't commit the config change as I was unsure if I'm supposed to leave that to maintainers :)

@tunetheweb
Copy link
Member

Yeah will flip it back before merging so it won't accidentally go live before we give it a round of editing. But find it best to have it on for this stage for convenience without having to remember not to commit it each time!

@github-actions
Copy link
Contributor

Images automagically compressed by Calibre's image-actions

Compression reduced images by 20.9%, saving 288.83 KB.

Filename Before After Improvement Visual comparison
src/static/images/2021/webassembly/br_savings.png 83.78 KB 68.20 KB -18.6% View diff
src/static/images/2021/webassembly/br_sizes.png 82.13 KB 65.11 KB -20.7% View diff
src/static/images/2021/webassembly/compression_methods.png 65.02 KB 50.29 KB -22.6% View diff
src/static/images/2021/webassembly/counts.png 47.66 KB 41.88 KB -12.1% View diff
src/static/images/2021/webassembly/cross_domain.png 50.20 KB 42.64 KB -15.1% View diff
src/static/images/2021/webassembly/instruction_kinds.png 101.54 KB 74.16 KB -27.0% View diff
src/static/images/2021/webassembly/mime_types.png 90.78 KB 71.98 KB -20.7% View diff
src/static/images/2021/webassembly/popular_by_name.png 61.40 KB 51.09 KB -16.8% View diff
src/static/images/2021/webassembly/proposals.png 92.02 KB 76.04 KB -17.4% View diff
src/static/images/2021/webassembly/raw_resp_sizes.png 84.02 KB 65.59 KB -21.9% View diff
src/static/images/2021/webassembly/section_sizes.png 70.00 KB 53.61 KB -23.4% View diff
src/static/images/2021/webassembly/strip_br_savings.png 68.08 KB 57.96 KB -14.9% View diff
src/static/images/2021/webassembly/uncompressed_resp_sizes.png 86.56 KB 66.86 KB -22.8% View diff
src/static/images/2021/webassembly/wasm_opt_bench.png 123.77 KB 92.15 KB -25.6% View diff
src/static/images/2021/webassembly/wasm_opt_br_bench.png 121.41 KB 89.91 KB -25.9% View diff
src/static/images/2021/webassembly/wasm_opt_br_savings.png 74.92 KB 61.70 KB -17.7% View diff
src/static/images/2021/webassembly/wasm_opt_savings.png 78.96 KB 64.25 KB -18.6% View diff

1270 images did not require optimisation.

@RReverser RReverser marked this pull request as ready for review November 19, 2021 20:44
@RReverser
Copy link
Member Author

Still need to address some TODOs in metadata, but content-wise this should be ready for the first round of feedback.

@github-actions
Copy link
Contributor

Images automagically compressed by Calibre's image-actions

Compression reduced images by 20.9%, saving 303.42 KB.

Filename Before After Improvement Visual comparison
src/static/images/2021/webassembly/br_savings.png 83.78 KB 68.20 KB -18.6% View diff
src/static/images/2021/webassembly/br_sizes.png 82.13 KB 65.11 KB -20.7% View diff
src/static/images/2021/webassembly/compression_methods.png 65.02 KB 50.29 KB -22.6% View diff
src/static/images/2021/webassembly/counts.png 47.66 KB 41.88 KB -12.1% View diff
src/static/images/2021/webassembly/cross_domain.png 54.76 KB 45.45 KB -17.0% View diff
src/static/images/2021/webassembly/instruction_kinds.png 101.54 KB 74.16 KB -27.0% View diff
src/static/images/2021/webassembly/mime_types.png 90.78 KB 71.98 KB -20.7% View diff
src/static/images/2021/webassembly/popular_by_name.png 128.93 KB 105.79 KB -17.9% View diff
src/static/images/2021/webassembly/proposals.png 92.02 KB 76.04 KB -17.4% View diff
src/static/images/2021/webassembly/raw_resp_sizes.png 84.02 KB 65.59 KB -21.9% View diff
src/static/images/2021/webassembly/section_sizes.png 70.00 KB 53.61 KB -23.4% View diff
src/static/images/2021/webassembly/strip_br_savings.png 68.08 KB 57.96 KB -14.9% View diff
src/static/images/2021/webassembly/uncompressed_resp_sizes.png 86.56 KB 66.86 KB -22.8% View diff
src/static/images/2021/webassembly/wasm_opt_bench.png 123.77 KB 92.15 KB -25.6% View diff
src/static/images/2021/webassembly/wasm_opt_br_bench.png 121.41 KB 89.91 KB -25.9% View diff
src/static/images/2021/webassembly/wasm_opt_br_savings.png 74.92 KB 61.70 KB -17.7% View diff
src/static/images/2021/webassembly/wasm_opt_savings.png 78.96 KB 64.25 KB -18.6% View diff

1270 images did not require optimisation.

@rviscomi
Copy link
Member

A table would be a good option if the extreme percentiles are needed and orders of magnitude different.

@RReverser
Copy link
Member Author

A table would be a good option if the extreme percentiles are needed and orders of magnitude different.

Do you mean a table in addition to the graph or instead of one?

@rviscomi
Copy link
Member

I was thinking instead of a chart.

@tunetheweb
Copy link
Member

Ah right. I think it's worth returning them back in this graph too, or splitting it into two graphs if it doesn't fit: https://20211121t105115-dot-webalmanac.uk.r.appspot.com/static/images/2021/webassembly/popular_by_name.png

Otherwise right now we have few libraries that are present only on mobile yet don't have labels, as well as few where usage significantly differs.

Added back in in 3873de2. Made the labels 14px rather than 16px and extended the height a bit more. Updated the staging link (might take a few mins for cache to update though).

It's not ideal, I admit, but unfortunately that is the Web Almanac style for now.

Yeah I wish there was a better solution, but leaving that up to you :) Meanwhile it might be worth updating the dataviz templates if that's indeed the style we go with for all articles.

Well we do use the black on inner green labels. Plus it stands out so one I always spot when doing a review. I wish sheets allowed a text outline. Green text with black outline would look OK I think. But alas it doesn't support that.

A table would be a good option if the extreme percentiles are needed and orders of magnitude different.

Do you mean a table in addition to the graph or instead of one?

I was thinking instead of a chart.

Do you wanna have a think about it @RReverser and update this branch? I'll not touch it any more until I hear back from you.

@RReverser
Copy link
Member Author

Do you wanna have a think about it @RReverser and update this branch? I'll not touch it any more until I hear back from you.

I think I'd like to keep the charts at least for 10-90 range (visualizations are so pretty! 😅) but yeah let me get back to you tomorrow.

@RReverser
Copy link
Member Author

Is there anything to change in text or is someone else going to review it too?

@tunetheweb
Copy link
Member

Is there anything to change in text or is someone else going to review it too?

We'll do a copy edit of the text after this is merged. I like to get the controversial things out of the way in the main PR as much as possible, so that copyedit PR is easier for you to review — rather than everything having changed cause I rearranged the figures completely or the like 😁 Hopefully should just be a quick spelling and grammar check.

@tunetheweb
Copy link
Member

tunetheweb commented Nov 22, 2021

I think I'd like to keep the charts at least for 10-90 range (visualizations are so pretty! 😅)

+1 to this!

@RReverser
Copy link
Member Author

RReverser commented Nov 23, 2021

Looks like this graph got cut off after the last update:

Nevermind I didn't do git pull.

@RReverser
Copy link
Member Author

Ok I think going with just big numbers or text where appropriate is good enough after all. I've adjusted wording under a graph where we removed 0% percentile.

@RReverser
Copy link
Member Author

FWIW I think I'm done with the graphs, please take another look and rerender where necessary.

@tunetheweb
Copy link
Member

Images updated. This good to merge now @RReverser ?

@RReverser
Copy link
Member Author

I think so, thanks! I could definitely use some extra eyes on text and perhaps on KB -> MB conversions (I've noticed few places where I messed it up during last go through the text) but you said we'll do text review in a separate PR?

@tunetheweb
Copy link
Member

Yup. Let's merge this and do that separate.

Thanks very much for being so patient with all my requests. but think we made it better so hopefully you'll agree it was worth it!

@tunetheweb tunetheweb merged commit 739343b into main Nov 25, 2021
@tunetheweb tunetheweb deleted the wasm-chapter branch November 25, 2021 16:51
@RReverser
Copy link
Member Author

RReverser commented Nov 25, 2021

Yup. Let's merge this and do that separate.

Thanks very much for being so patient with all my requests. but think we made it better so hopefully you'll agree it was worth it!

I mean, I still miss my extremes, but I agree it looks more consistent and better overall 😀 Thanks for all your help.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
writing Related to wording and content
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants