[thefalcon]

As a counterpoint: the example of the document containing blocks of code inside what looked more like a word document, to me, exactly explains visually what "designed for humans" means in this context, and I think it's well put.

[mkozlows]

That's not revolutionary at all. You can do that already with tons of environments. Here's one for Javascript, based on Markdown: https://github.com/jostylr/litpro

[oldmanjay]

Did someone make a rule that everything needs to be a revolution?

[tempodox]

Yes, it's called advertising.

[zubairq]

Can you post a link so that I can try litpro? Or does it need a download and installation?

[blowski]

While I like the idea, the problem with the demo is that it has about 10 files, with a bunch of small code blocks. What does it look like in a real-world application with 1000s lines in 100s of files?

[zenobit256]

I'm sorry, but that doesn't give the connotation that it's "designed for humans". Perhaps if they could give a clear indication of what that means other than "it's in a word document", I'd be more inclined to look at it a little harder.

[Pyxl101]

Watching the video is probably the best way to get an understanding of what it's about. It's hard to describe an "experience" with text. Their video made more sense to me than most of the written explanation.

[dsp1234]

It's hard to describe an "experience" with text.

That's kind of the the thing that literate programming is trying to solve[0]. But if the experts aren't able to do it for their own product, what chance does a random programmer have with their own code?

[0] - https://news.ycombinator.com/item?id=12818653

"When we communicate to one another face-to-face, we use gestures, expressions, intonation, etc. to articulate an idea. On the internet, when we communicate with just text, much of my meaning is lost forever and never apparent to anyone who reads this. Programming is much the same way."

[bpicolo]

You can do this with Jupyter notebooks.

[zubairq]

I just tried Jupyter... I couldn't figure it out. Could you post a link to a tutorial that I could use?

[jhomedall]

The easiest way (and the method I use) is to just use the version packaged with Anaconda. See: http://jupyter.readthedocs.io/en/latest/install.html#id3 .

There are also instructions on that page you can follow (installation via pip) if you already have a reasonably modern version of Python installed, and you have an appropriate C compiler available. This is a pain to configure if you are using a Windows machine.

Assuming the 'jupyter notebook' command succeeds, a browser window should pop up, displaying a UI for manipulating individual notebooks.

If you have already successfully completed the installation, and are instead looking for guidance on using Jupyter Notebook itself, then your best bet would be to look at some of the examples: https://try.jupyter.org/

[zubairq]

I tried the https://try.jupyter.org/ and that was what I could not figure out. It looks like some kind of csv editor once I got to see some output