Hacker News Reader

Comment by chrisparnin | Hacker News Reader

Thanks for trying it out. We have a bit of work to make bootstrap process easier.

We have a limited set of notebooks published online to demo how they work. For example:

* https://docable.cloud/chrisparnin/examples/basics/script.md

* https://docable.cloud/chrisparnin/examples/tutorials/Git.md

Right now, we're using the notebooks to build better lecture materials + workshops, especially for my DevOps course: https://github.com/CSC-DevOps/Course

We've seen some interest in having support for live documentation + OneOps (simple runbooks for one-off devops tasks), so we'll probably continue to explore this more.

View on HN

Nice, thanks for sharing the demos. Was sharing it at work and its hard to convince people to install something to try it out.

I was wondering about the commercial side, because I noticed that the code responsible for turning it into a "hosted" notebook was kept outside of the main repo, which seems common in SaaS approached.

Anyhow, using it for teaching is definitely a good purpose! In fact, it's the use case which sparked my interest. At work we give trainings and the training materials [1] are already in Markdown, so making them interactive by merely annotating them seems easy enough.

I'm happy to see these DevOps courses take off, two years ago when I was finishing my bachelors in CS DevOps wasn't even part of the curriculum. Being able to implement algorithms and architect code. Now these courses are everywhere and well up to date with the industries best practices.

[1] https://github.com/eficode-academy

Chris:

Thanks for including the link to your paper[1] in the README. I saved it in my Zotero library and am looking forward to reading it.

Do you have any thoughts or experience with literate programming? What about the role of Docable, versus choosing PDF as the medium for your own paper, versus something like this[2] sort of thing?

1. http://chrisparnin.me/pdf/docable_FSE_20.pdf

2. https://csarven.ca/this-paper-is-a-demo

Living papers are useful vision, but it will take a long way to get there.

Even notebooks still are problematic, for example, this study found that only 25% of Jupyter notebooks could be executed, and of those, only 4% actually reproduced the same results.

http://www.ic.uff.br/~leomurta/papers/pimentel2019a.pdf

One compromise is to evaluate the paper separate from it's artifacts, which are reviewed for availability, reproducibility, and reusability. In software engineering conferences, this is becoming a standard, and while there is a huge burden for reviewers to evaluate these things, I think it does take us in the right direction. So in this case, we also submitted our paper for evaluation for its artifacts.

Reply on news.ycombinator.com