cljdoc

https://cljdoc.org/ & https://github.com/cljdoc/cljdoc
2018-11-17T12:45:54.115100Z

[intent: just chatting] [definitely off topic] I have an idea a little crazy .. there is this browser called [beaker browser](https://beakerbrowser.com/) which is good at updating and displaying offline static sites. I am wondering if in the long term it would be a good target for a fully offline user experience. However, I think that cljdoc would need a lot of changes to fit that project.

martinklepsch 2018-11-17T13:12:51.115700Z

I've seen beaker browser and it definitely seems cool. Just wondering, have you already seen cljdoc's offline bundles? https://cljdoc.org/download/manifold/manifold/0.1.8

2018-11-17T13:22:21.115900Z

I just took a look and that's pretty good. A port to Beaker is within reach.

2018-11-17T13:23:34.116100Z

The bundles in cljdoc have to be downloaded in advance one by one by the user, so s/he needs to know what s/he wants ahead of time.

2018-11-17T13:26:29.116300Z

With the beaker port, the user could in theory just update the whole set of documentation using a single interaction while still online, and can decide later which library s/he need to read. Note: I have zero experience using beaker as a website programmer, I don't know if the data size of a website has a limit on it.

2018-11-17T13:28:03.116500Z

Does cljdoc have a uber-all-projects downloadable offline bundle?

martinklepsch 2018-11-17T13:42:58.116900Z

It doesn't at this time

2018-11-17T14:38:52.118400Z

I am trying to get the project running on my computer and it runs, but there are some errors displayed in my terminal, I don't know if it is to be expected or if I have a wrong setup.

2018-11-17T14:41:03.118700Z

This is the current master branch.

2018-11-17T14:54:53.118900Z

The errors in the log did not show any problem from the browser's user's perspective.

2018-11-17T15:01:24.123800Z

My feedback on the "get started" process for new comers: When I followed the instructions to run the server locally, I ran into a small problem where the website complained that I did not built the JS files, even if I did it already. The problem disappears after I interrupted the server and restarted it, with the js file already been built. I followed the chronological order of the documentation. Maybe I needed to build the JS files before running the server to avoid the problem.

2018-11-17T15:12:48.125Z

Contribution workflow question: I found some minor typos in the project, should I point to them via comments in Github or do a PR?

martinklepsch 2018-11-17T15:34:38.126600Z

> I followed the chronological order of the documentation. Maybe I needed to build the JS files before running the server to avoid the problem. Another contributor also ran into that issue. I think the problem is that resources-compiled doesn't exist when the server (or process) is started. If it's about the server then we could probably just .mkdir it before starting the server. If it's the process we should update the documentation. But generally the more independent those things are the better.

martinklepsch 2018-11-17T15:35:02.127Z

So did you restart the entire clj process or just the system?

martinklepsch 2018-11-17T15:35:30.127600Z

> Contribution workflow question: I found some minor typos in the project, should I point to them via comments in Github or do a PR? (edited) PR is easier to integrate, also happy to give you commit access if you're worries about to many PRs creating noise