Hacker News new | past | comments | ask | show | jobs | submit login

"You don't know x."

"10 things you didn't know about y."

"Everything you thought you knew about z is wrong."

Am I the only one that finds titles like this completely offputting? If you think you have insight that's useful to people, try not talking down to them. As it is, hell, I may not know Javascript, but I'm certainly not clicking through.




I explain the title, and the intended tone and purpose of the book series, in the preface. If you wouldn't mind taking the 3 minutes to read it, I'd be curious if it changes anything about your opinion of the title:

https://github.com/getify/You-Dont-Know-JS/blob/master/prefa...


Nope, it still doesn't work for me, personally. I never played "You Don't Know Jack", and so I tend to interpret your title literally. And your title implies that no matter how much somebody knows about JavaScript, it's not enough.

Two decades ago, I was really into learning all the disgusting corners of badly-designed programming languages. I got really excited about C++ implicit conversions and clever template hacks. But that always proved to be a mistake, because nobody wants to read or maintain any of that crap.

These days, I try to focus on the essentials of a language: What works well and portably? What offers unique expressive capabilities that I haven't seen before? What's idiomatic? If I learn any nasty corner-cases, I only do it solve a specific problem, or to avoid pitfalls.

I really can't get excited about the implicit conversion semantics of JavaScript's "==" operator or the weirder points of how "this" get bound in callbacks. It's all just pointless technical arcana. If something neither expands my brain nor solves an immediate commercial problem, I'm happy ignoring it until it becomes obsolete. And my clients are usually a lot happier, too.

(That said, the actual books are nicely written. But you asked about the titles.)


This. "Technical arcana" is exactly right.

Your code should rarely be clever or rely on the the weird dark corner-case cruft of a language. Too often I see JS code written like an entry in the Obfuscated C contest. Yes, that code can work, but don't do that.


The books point all the arcane points of the language so that the reader can understand them. They're also full of commentary like "never do this".

Rather than most books which gloss over the "bad parts", which prevents people from fuller learning and leaves them to their own devices when they run across that stuff in the real world, YDKJS covers all the parts, and tries to use the deeper understanding as a tool and guide to making better-informed decisions about how to effectively write JS.

I think it's entirely unfair to suggest that covering "technical arcana" is the same thing as endorsing it.


I never once mentioned your books Kyle. I actually enjoy the parts that I've read. I was making a broader point that I have witnessed with the JS community: using technical arcana in production code as if it was a good thing. Just one example: https://github.com/twbs/bootstrap/issues/3057


Having played the "You Don't Know Jack" PC game from 1995 I found the title playful. From your preface I see you'll be doing exactly what I wanted from a book with this title. Going into all the areas I never would in a programming language. Not just how but why.

I agree with the GP though, on feeling some fatigue around people telling me I'm doing something wrong. Eating food, reading a book, tying my shoes, putting on a shirt. Anyhow it seems like you've just touched on that area a bit for this person. Experts don't like for Dummies books, not because they are rubbish, which they might be, but because owning or reading them visibly puts into question their knowledge and challenges their self image. In the same way someone might find your title a challenge to their knowledge, instead of seeing that you're interested in highlighting often overlooked things about JS.

For the love of God please don't put a giant headed person on your cover though. I've come to terms with every other book series having a positive quality with the exception of "Head First" and their distorted human cover photos. /rant

We all have our ticks when it comes to books and advertising around things we love.


> For the love of God please don't put a giant headed person on your cover though

These are what the covers of all the books in the series look like:

http://shop.oreilly.com/product/0636920026327.do

------

side note: my kickstarter for the books, 2 years ago, playfully used the bald head image to catch people's attention (never the intended branding). I soon afer got a friendly lawyer takedown notice from the folks who own the game. We worked it out, and the new branding was born. :)


I'd suggest, "The Tough Parts", as you mention in the preface.

Not sure who your target market is but as a professional developer who writes javascript daily, "The Tough Parts", piques my curiosity and sounds like an interesting challenge. "You Don't Know JS" evokes a more negative reaction.


fyi: there were some who felt that it would detract from or dillute the brand "the good parts", which is also an oreilly title.


Honestly, I don't care what the title is, the books are great. I've recommended them a number of times as newer resources than "the good parts" and raganwald's, and not one person has asked if I thought I was implying that they were dumb. If anything, the title serves as a compliment, since anything I do not know is something that I can learn. If you know everything already, then why are you looking at books which serve to teach?

That said, from a marketing perspective, they've got a great unique cover and a solid series title. If more than the original 5 come around in the future, they'll be easy to identify.


Sorry, but I think it should be clear from my comment that your title is indeed putting people off of reading your work at all. I don't doubt that it's worth reading, but I think you should consider that the title itself, accuracy aside, is dissuading more people than just me from reading your work.

The point isn't the quality of your work. It's your hook that's failing at least some of us to the point that you are potentially missing out on part of your target audience by default.


I understand and appreciate your feedback. Unfortunately, given that most of the series is done and half of them are already in print, it's too late to change.

I did have lengthy discussions with my book editor about the title and its potential to be off-putting to some. We wrangled with the decision awhile, but ultimately came to the conclusion that most would find it a mix/balance of playful, attention grabbing (in a sea of "JS: The Handy Guide" type titles), and challenging.

The title itself is supposed to be equal parts a joke and a serious commentary on what I consider to be a disturbing trend in JS specifically, which is either a false sense of confidence or (worse) an apathy to not care about what is not known.

Again, thank you for your thoughtful response and your feedback. I do regret that it's hit you the way it has. Perhaps at some point you may give it another shot.


really there are people who complains about the name of the book? it's clearly a joke.


Yup. The original talks were called "Advanced JS: The 'What You Need To Know' Parts" - and I'd much rather have a book with _that_ title on my desk, rather than one that makes it look like I'm reading a "...For Dummies" book.


Just putting it out there but knocking the "For Dummies" books based on the title is a bit pretentious. Sure, the title doesn't really make you look good but the books are often well written and informative. They have a great layout and serve well as introductory books.

In fact, I'd go as far as to say a lot of other books could learn a lot from the layout of the series. I've read many books and the dry books don't hold my attention for long. There is something to be said for books you just absorb.


I find the for Dummies books nearly unusable due to the evident required number of puns and homespun regular folks observations between every bit of actual technical info.


Yeah if For Dummies would just kill off the bad jokes it'd actually be easier to read. I don't like cringing through a book when I'm trying to learn something.


Maybe it's a play on how horrible the language is?

E.g. "You don't know what callback hell means. You don't know the horror of refactoring a weakly typed dynamic language. You are truly blessed for you don't know JS."


If the post was titled "In-depth look at Javascript" or something, I might've skip it. This title piqued my interest because I write Javascript for living for a long time and I was genuinely wondering what I don't know yet about the language.


and did you learn anything new? just wondering


There's a bunch of stuff here even folk with a few years may not know. See the generators section at https://github.com/getify/You-Dont-Know-JS/blob/master/async...

Learning JS is very different from other languages in that there's greater amounts of misinformation (lots of people know it, but prefer to use it as little as possible), and it changes faster. For example, in 2015:

- you won't find any Python new articles that tell you to use Python 1's 'strings' module

- You'll still see things like <script> tag soup, 'JS isn't object oriented', globals and patchable-ES3-isms in new JS articles.

Kyle Simpson is a well known JS speaker and O Reilly author - his books are a great source of current best practice.


I've read the book and even contributed a tiny tiny bit with issues in GH (the book is managed through GH). While I didn't learn much I did gain perspective about things so I'd say reading it was definitely worth my time.


Just wanted to say I appreciate any contributions (even "tiny tiny bit") you've made on GH. :)


Didn't read the whole thing yet :). But glancing through it it seems that I really have some stuff to learn about Javascript internals.


Likewise. I'll read the books on Safari Books Online using the work subscription, just to fill in the gaps. I'm pretty sure I will actually learn something.


Am I the only one that finds titles like this completely offputting?

No, you aren't, though FWIW I try to force myself to at least look at what's been submitted before commenting, in the spirit of not judging books by covers and all that.

In this case, I found very little to suggest that I do not, in fact, know JavaScript.

I'm also assuming that this is a very early draft of the material, but it could certainly benefit from the input of a good editor before any final publication.


> I found very little to suggest

Just curious what parts you looked at? Did you glance at the table of contents, or did you read full chapters? I certainly tried to reveal in every chapter several different things that, in my professional experience teaching JS to teams of developers, are commonly misunderstood or under-understood.

If you had any specific feedback on what I could have done better to live up to the title, tone, and mission of the book series, I'd be appreciative of it.

> very early draft

Depends on which book(s) you looked at. The series is 18 months old by now, with 6 titles. 5 of them are already "complete".

3 of them have already been edited and published (though publisher edits didn't necessarily all make it back into the free repo versions).

2 of them are in final editing and production stages, so they're still being cleaned up. The sixth one is still a very early and partial draft, so it's quite rough.


Just curious what parts you looked at? Did you glance at the table of contents, or did you read full chapters?

I skimmed through pretty much all of "Scope & Closures". I also looked through the first few chapters of "this & Object Prototypes" to see whether they were any better.

If you had any specific feedback on what I could have done better to live up to the title, tone, and mission of the book series, I'd be appreciative of it.

Sadly, with that title and your chosen goals, I think you left yourself no chance of meeting expectations right from the start. If you're going to tell me I don't know a language I've been using for 20 years, you'd better mean it in the sense that there is something significant and new in your book, perhaps some cutting edge developments in the language itself, or maybe an original application or new perspective on how to use what was already there. In this case, the closest you get in the books I looked at is touching on a few basics of ES6 -- nothing wrong with that, but hardly earth-shattering news to a professional who runs 6to5 (ahem sorry, Babel) every day.

Leaving aside the title, though, the material is often surprisingly narrow and imprecise if your intention is to teach the subtle details of JavaScript more thoroughly than many programmers might know them already.

Your opening paragraph of chapter 1 makes several debatable claims. For example, your characterisation of mutable variables as fundamental to nearly all programming languages immediately ignores alternatives such as purely functional or logic languages. That is perhaps an unfortunate choice given the current trends in JS libraries and frameworks, which in many cases are moving in that more declarative direction.

You then seem to conflate various concepts of scope, storage and lifetime throughout the book, and similarly do not seem to distinguish clearly and consistently between the concepts of identifiers, variables and values. In a language where closures and references to functions are used routinely and where you have some types passed by value but others effectively passed by reference, these kinds of distinctions matter, particularly to someone who has learned by osmosis or perhaps come from a background working with other programming languages, which seems to be a lot of your target audience here.

More generally, your terminology tends to drift away from the ECMAScript spec quite a lot, again making it less precise. Another example would be the opening paragraph of chapter 1 of "this & Object Prototypes", where you describe this as being a "special identifier keyword". By definition (in the spec) an identifier can't be a keyword, because an identifier is precisely an identifier name that is not a reserved word.

The most vague section of those I read was probably when you discuss closures in the final chapter, where I'm sorry to say you come across as rather unfamiliar with the concept yourself. Your usage is somewhat casual, unidiomatic even, not least in your definition of the term itself. Your explanation for where closures come from ("Closures happen as a result of writing code that relies on lexical scope. They just happen.") is just plain wrong, as evidenced by the fact that numerous languages with lexical scope do not provide closures as a language feature at all.

Sorry if this all seems a bit nit-picky, but you did just write a book about the importance of understanding the details and telling me I didn't know the language. :-)


It seems that you are offput by his title in a way that you feel he is personally challenging your knowledge and experience with JavaScript. I would guess that when he was writing and naming this series, he did not have someone with 20 years experience in mind. Seems like the series is geared towards someone with moderate experience.


I don't think the title is the big issue here. I don't think it's good, and clearly it does put some people off with its tone, but as you say, maybe at least some of those people aren't the intended target audience.

My stronger reservation is that these books have a lot of loose writing and give so much space over to asides or describing bad practices that someone who wasn't so experienced might still not know JS by the end, having missed the wood for the trees.


It's easy to be a critic. On the internet it's even possible to be a popular critic on a topic by admitting that one hasn't even read the subject of the criticism. In the world of male tech, one can easily achieve top common in an HN thread exactly for judging a book by its cover.

Anyone who doesn't have imposter syndrome hasn't tried the exercises in TAoCP.


> It's easy to be a critic.

In fact it's so easy that you can make a snide comment criticizing someone else's criticism and it will do really well if you throw in some unnecessary and ridiculous "male dominated" comment.


It wouldn't be a Hacker News thread without the top comment being an "Am I the only one...?"


It's probably a play on the "you don't know jack" trivia game.


More likely the common phrase, "you don't know jack shit".


the game was a play on that phrase, and my book title is a play on both. :)


I thought it was an homage to You Don't Know Jack (http://en.wikipedia.org/wiki/You_Don%27t_Know_Jack_%28video_...). I read the title as "You Don't Know Jack Squat," haha. I don't know if that was the author's intent, though.


Yes, that was my intended (subtle) joke.


That takes me back! Never thought I'd see that again...


Actually, I'm fine with these titles. It's the "Dummies", "Idiot's", etc titles that I find offensive.

My problem is (usually) ignorance, and I'm looking to correct that. If I'm an idiot, no book will fix that.


I think it says more about your ego imo. I mean you're getting worked up about a book's title to the point that you won't look at its content. Just because it insinuated you don't know said content.

It's amusing if anything.


""You don't know x." titles considered harmful."




Applications are open for YC Winter 2021

Guidelines | FAQ | Support | API | Security | Lists | Bookmarklet | Legal | Apply to YC | Contact

Search: