planck

Planck ClojureScript REPL
pyrmont 2019-05-20T23:54:45.044600Z

@mfikes Did you want help with #930 or have you already started and created the issue mostly as a to-do item? I can start going through and pulling stuff out.

mfikes 2019-05-20T23:55:31.046400Z

I haven't started on it. Feel free to assign to yourself and dig into it.

pyrmont 2019-05-20T23:56:05.047700Z

I did have a question about what documentation should exist on the site itself. The user guide is no longer linked directly from the front page but in the cljdoc docs there are still links to it. On the other hand, all the user guide pages appear to be listed on cljdoc as articles. So maybe all the documentation is supposed to just be there now?

mfikes 2019-05-20T23:58:04.049400Z

Yeah, I think that in the end, the http://planck-repl.org site might be just a shell of what it used to be (a place for the main page, a place to host downloads, etc.). I see no issue if all the user guide articles and (especially) all the SDK documentation live on cljdoc.

mfikes 2019-05-20T23:58:22.049900Z

(When http://planck-repl.org was created, cljdoc didn't yet exist IIRC.)

mfikes 2019-05-20T23:59:06.051400Z

At a high level, I think we only need to retain the article *.md files, and the main thing that can go is all the manually written SDK docs

pyrmont 2019-05-20T23:59:23.052300Z

I'll miss the single page guide. I found that helpful for searches. I'm looking at cljdoc on my phone and maybe that's why but it doesn't appear to have its own search functionality.

mfikes 2019-05-20T23:59:29.052500Z

script/build should still work so script/deploy can push out the main high level page or two

mfikes 2019-05-20T23:59:55.053600Z

Ahh, yeah, that's a good point. In a single page you can find things easily. 🙂

pyrmont 2019-05-20T23:59:57.053700Z

But having said that, automated documentation and having everything in one place is a win.