Thoughts on Present Version

[colah]

Hi All!

I just went over the article again. It's looking great! I had a few small comments. Note that these aren't Distill editorial feedback, and you aren't obligated to take any of it.

• I was skeptical about the collapsible sections, but I'm coming around! :)

• While rereading, I was struck that the video example from Charade could potentially be perceived as making a gender stereotype (ie. "women are prone to nervous breakdowns"). I feel like I'm not super calibrated on this kind of thing, and I realize you're working in a lot of constraints, like making it public domain and that you already had to switch it once before... But if it's convenient to swap out, you might consider doing so.

• A couple ideas for sharpening the (very interesting!) section on comparing FILM parameters of feature maps:
  • Used circles to suggest the filters are selectable.
  • Label what the filters are
  • Use one set of labels to filter both plots
  • Sharpen the captioning to make it fast to realize what the difference between the two parts is.
  • (consider also aligning the beta-gamma grids)

• The last t-SNE plot seems like it might be broken on drafts (but maybe you've already fixed it and it hasn't rebuilt?)

(A couple other thoughts: consider making it possible to hover over the labels rather than just the circles in the legend.)

[vdumoulin]

@colah thanks a lot for your feedback!

I'll address it gradually over time, but I think you identified one pressing issue: the Charade still frame. I'm glad that you pointed it out, as I hadn't realized that it could come off as making a gender stereotype (which in hindsight I should have caught sooner). Needless to say, this is definitely not our intention, so I'll find a replacement ASAP.

[arvind]

The last t-SNE plot seems like it might be broken on drafts (but maybe you've already fixed it and it hasn't rebuilt?)

Aha, I tracked down why this is broken online but working locally.

@vdumoulin, I believe github.io supports https (https://ariutta.github.io/svg-pan-zoom/dist/svg-pan-zoom.min.js resolves for me). Alternatively, you could copy the js library into your static folder and reference it from there. I may have a slight preference for the latter to increase future proofing.

[colah]

A few more thoughts:

• Several of the new diagrams could benefit from a bit more labeling and emphasizing key words. This would make them easier to understand as someone quickly skims through. This might also allow you to make the captions a bit shorter. For example:

• Some alternate interfaces for the interpolation stuff:

or

[fstrub95]

to fix the https bug, we can either install the package with npm (I anticipated this scenario in the code) or copy past the jascript in public. To use with browserify, follow these steps: - Add the package as node module npm install --save ariutta/svg-pan-zoom - Require *svg-pan-zoom* in your source file svgPanZoom = require('svg-pan-zoom') source:https://github.com/ariutta/svg-pan-zoom/blob/master/README.md On a different point, the image mask on clevr (interpolation) does not work on firefox. but i do not know how to fix it

…

On Fri, Jun 29, 2018, 11:44 PM Arvind Satyanarayan ***@***.***> wrote: The last t-SNE plot seems like it might be broken on drafts (but maybe you've already fixed it and it hasn't rebuilt?) Aha, I tracked down why this is broken online but working locally. [image: image] <https://user-images.githubusercontent.com/42262/42116075-9ab164e4-7baa-11e8-8a38-947958c663a8.png> @vdumoulin <https://github.com/vdumoulin>, I believe github.io supports https (https://ariutta.github.io/svg-pan-zoom/dist/svg-pan-zoom.min.js resolves for me). Alternatively, you could copy the js library into your static folder and reference it from there. I may have a slight preference for the latter to increase future proofing. — You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub <#222 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AMvzhBkKFaaNcboDG-tKB-5XOkjZDTg7ks5uBp_RgaJpZM4U9j6X> .

[vdumoulin]

@colah here are new figure designs following your feedback:

[colah]

Looks nice! :)