September 2018 Monthly Update

Clojurists Together news

September was a successful month. We have new project updates and results from our quarterly survey. Don’t forget, CT is currently accepting applications for our 4th Quarter Call for Proposals.

Check out this great video presentation from Martin Klepsch on Documenting the Clojure/Script Ecosystem.

Thanks to all of our members who support Clojurists Together. It’s thanks to your generous support that we can do this.

cljdoc updates

Hey dear ClojuristsTogether crew! This is Martin with a quick update on cljdoc.

September has been a somewhat slow month. I’ve been focused on preparing my ClojuTRE talk about cljdoc the first half of September and was mostly offline — on a sailboat — the second half of September. You can watch the talk on YouTube. I’m also thanking all of you at the end of the talk.

Despite me being absent some PRs were opened & merged. Thanks to Travis McNeill and Saskia Lindner for that. It’s great to see people contributing and I hope to grow the cljdoc community further over the next months.

In the same vein Saskia and I are putting together a cljdoc hackday in Berlin on Thursday 11th October from 2pm, join the #cljdoc Slack channel on clojurians.net for details.

Things that have been shipped in September:

• A toggle to view raw docstrings (PR #117)
• A first iteration at what may become an interactive article TOC, currently just showing what section you’re in (PR #116)
• OpenGraph meta tags (cljdoc links should render much nicer on Slack, Twitter & co)
• An issue with UTF-8 article slugs has been fixed
• Cleanups in various places of the code removing unused code
• Improvements to the way the classpath is constructed for analysis (commit)
• A bug with links in offline docs has been fixed (commit)

After ClojuTRE and my vacation I’m feeling energized to work on cljdoc again in October. Priorities will be the integration of examples and community building.

If you want to help cljdoc with 5 minutes of your time: add a badge to your project’s Readme. In order to achieve the vision I outlined in my ClojuTRE talk the community needs to be aware this thing exists — and that’s not something I’ll ever be able to achieve on my own.

So point people to cljdoc and — if you’re feeling particularly excited — tweet or write a blogpost about it.

Thanks for your support <3

Shadow CLJS updates

Release of shadow-cljs versions to 2.6.7 to 2.6.8

UI Work

Here’s a preview video of the shadow-cljs UI. I’ve also tweaked the UI to display warnings better.

Minor changes

• Added support for :parallel-build false, true by default but wasn’t configurable before.
• Copied clojure.core.specs.alpha and adjusted them for CLJS. Clojure 1.10 alpha renamed a few specs and broke the direct use that was previously used.

Release of shadow-cljs versions to 2.6.9 to 2.6.10

UI Work

• [WIP] Implemented basic REPL support in the UI
• [WIP] Implemented basic standalone Launcher using Electron

Bugfixes

• fixed a REPL issue related to require and browser reload
• added support for overriding npm resolves to exclude packages from a build
• fixed a race condition related to async loading the web-related namespaces