thomas-tanay / post--L2-regularization

Distill submission
33 stars 1 forks source link

Abstract #10

Open colah opened 6 years ago

colah commented 6 years ago

General Comments

At the moment, your article opens with a short section giving a flavor of the content of the article:

image

I think this is a really good direction, but is trying to be too many things at once right now. In particular, it feels like it's playing a balancing act between being a visual abstract (which I think would try to be more focused and brief) and an introduction (which would provide more context).

In doing so, it falls into a bit of an uncanny valley: It doesn't quite have enough context to really get what's going on if you come in knowing about adversarial examples but not the ideas in this article. Readers will suspend the expectation of really knowing what's going on for a cool "teaser" at the top of an article, but once it starts to feel like a full section they get confused.

My inclination is to tighten this into a visual abstract / teaser / hero, and use the background section as an introduction (which it already is and does quite well).

Specific advice:

1. Figure out the angle / core point

There's a lot of interesting things about your article:

I think you want to pick out a couple that are interesting, hook the reader, and give the flavor of your article.

2. Focus

Then you want to boil it down into a few sentences and an interactive. At the very dense end, you could do something like this:

image

But I'd avoid trying to squeeze in that much text.

3. Include a bit more context if possible.

This is in tension with other things I've said, but I think you could give a bit more context. That said, I think you'll also make it a lot less important by making it shorter and queuing the reader that they don't have to understand everything that's going on here.

4. Make it interactive, not a video.

The interactive at the top is kind of a video right now. You hit play and it goes. If possible, it would be better for the reader to be able to fiddle directly with the regularization parameter.

Examples

Here's one example of what a tight visual abstract might look like. It cuts a lot of nice stuff, but you have lots of space to talk about the content you didn't mention here later in the article. The goal at this point is to interest the reader.

image

Or with a different focus:

image

thomas-tanay commented 6 years ago

These are all very good points. My initial objective was indeed to make a short visual abstract, but I got caught into trying to summarize everything.

I will probably go for something like your first suggestion:

31203940-3679e1c2-a91e-11e7-94a5-20f9b3af91e4

(showing the tilting plane animation on MNIST is actually what motivated me to write this post in the first place -- I consider it to be the core idea of the article)

thomas-tanay commented 6 years ago

I just submitted a new version with a simplified abstract:

abstract

I am not completely satisfied with the design though, I will try to improve it in the coming days.

thomas-tanay commented 6 years ago

Here is what I have now:

abstract

colah commented 6 years ago

That looks great!

I think it might be possible to improve the alignment of the text and the diagram, but I'm not sure exactly how to do it. Shan may have thoughts.

It would add a little noise, but you could consider trying to visually display adversarial distance some how.

colah commented 6 years ago

A new version while I comment!

Does the orange represent adversarial distance? Or a margin between data points? (It feels a bit too thin to be the average adversarial distance.)

I really like including the adversarial distance or something closely related to it somehow. This seems like one good candidate. Another possibility might be to draw a single adversarial example...

thomas-tanay commented 6 years ago

ah that's a good point. At the moment the orange is the margin but I don't refer to it that much in the text.

I could replace that by the adversarial distance, which is the distance between each mean digit and the boundary.

colah commented 6 years ago

Yeah, I feel like adversarial distance is probably a more important idea for you than the margin...

The orange may git a bit overwhelming for adversarial distance though. You might need to experiment a bit.

thomas-tanay commented 6 years ago

I updated it so that the shaded area is now the adversarial distance. I'm still not completely sure about the colors, I might change them at some point.

abstract

colah commented 6 years ago

Looking nice!

thomas-tanay commented 6 years ago

abstract