[ronyeh]

> taken neither the time to understand Observable nor D3 and are looking for a way to just copy paste something into their codebase, without understanding it, and without any willingness to really learn the tools they are using.

That's how many of us learn, by dipping our toes into a new SDK by copying and pasting into our bare HTML/JS page and tweaking things to see what happens. Eventually we will get around to reading the full documentation.

I have made d3 examples and played around with the toolkit since back when it was in its infancy (called protovis or something). It has definitely become more and more difficult over the years for a beginner to jump into.

(Background: I have met Mike since I got my PhD from the hci/graphics lab at Stanford, but we did not overlap.)

[themulticaster]

This is my experience as well - when deciding whether to use a certain library or framework, I don't start reading the reference manual. Rather, I highly prefer looking at and tweaking existing examples, mostly to understand what the typical usage looks like and most importantly where the limitations lie.

I feel like the last point is often overlooked by documentation authors: When evaluating whether to use a library, I'm not just interested in what it can do, but also what it can't do! That's why I really enjoy the "you should use X if you want to do Y"/"you shouldn't use X if you want to do Z" sections present in some manuals.

[sam_goody]

this.

I am a beginner, and have spent hours in frustration, because I couldn't figure out the examples.

In every other project I would copy and paste some examples and start playing with it to understand.

[j-pb]

You make my point. What better environment to learn and twiddle, than a reactive, constantly reevaluating interactive notebook?

[ronyeh]

I don't know why others down voted you so I upvoted this comment.

All I am saying is that the d3 team needs a "getting started" page aimed at allowing a dev to include one script tag (or a single npm install) and then copy and paste examples from the example gallery to get it quickly working on their own test website.

I recently tried getting back into d3 and I gave up (opted for another low threshold SVG toolkit). It's fine if d3 is aimed at other people who want to use observable.... It's just not targeted at me anymore.

[j-pb]

I think that's actually a result of how D3 has changed over time. It has become much more modular and flexible, but also less "plug & play". In a sense it's a pro tool for custom data visulaisations, where everything is possible, but nothings easy.

I'd recommend Plot instead: https://observablehq.com/@observablehq/plot

It also works as a pure JS library, just like D3, but is based on a grammar of graphics idea, like ggplot. It's not infinitely flexible, but flexible enough, and build to get quickly to a chart, with as few lines as possible.

[duped]

I guess it depends on your goal. If your goal is to learn how to code a nice reactive environment like a notebook is great. If your goal is to learn how to take a library and use it in a piece of software to release to the world, the notebook is next to useless.

[j-pb]

If you think that the trivial differences between the two environments makes either of them useless to learn the other, franky I'll doubt you'll have the skill to learn D3 properly at all.

Taking a dom node and hooking it into the dom is not magic in D3. All that obervable does is hook in any dom node you return for you.

[protoduction]

I wasn't sure whether I was going to comment, but this kind of comment is rather unhelpful and poor form. Some may prefer not to have a (mock) notebook runtime in their application for good reason that has nothing to do with their skill.

I see you are passionate about defending Observable, and that's cool - it's a great piece of tech, but please remember that everybody's requirements are different and valid too.

[j-pb]

Then don't use the runtime and rewrite the code to plain js. All you have to do is declare cell contents as variables, and replace the first D3 select, that attaches to a reified dom node, with an #id selector. D3 is a series of tools, where the difficult parts are completely orthogonal to what observable provides.

It's like complaining that you can't learn how to drive in the evening, because there is a different sky color, than during the time you'll take your morning commute. The sky color is not the relevant nor difficult part.

I have my own (different) complaints about observable, but I'm sick and tired of bottom of the barrel programmers complaining about free stuff not being pre-digested enough for them.

[hu3]

Whatever environment each user prefers.

Being softlocked into Observable is not a pro.

That's like trying to force every vim user into Jetbrain IDEs (both are great, not trying to start a flamewar here).

Sure an IDE will have more features (like Observable vs simple HTML file), but it's important to understand different people have different ways of doing things.

[j-pb]

We're talking about a javascript repl here, don't blow it out of proportion. The things transfer trivially between the envionments. If having a javascript repl is such a show stopper for learning D3 for you, maybe learn javascript first.

[themulticaster]

But if the example transfers trivially, why is there no convenient "download example project" button that offers an archive containing all the necessary files I need to run the example?

[j-pb]

There is such a button.

Like I said, everyone I've seen complain so far, always turn out to not even want to learn basic stuff.

[ronyeh]

Ahh I must have missed this button. I will try to go look for it and report back when I have a d3 example working in my bare HTML page.