This page is not created by, affiliated with, or supported by Slack Technologies, Inc.
2018-10-04
Channels
- # 100-days-of-code (8)
- # announcements (4)
- # beginners (77)
- # boot (11)
- # business (13)
- # cider (69)
- # clara (2)
- # cljdoc (51)
- # clojure (59)
- # clojure-dev (18)
- # clojure-italy (4)
- # clojure-nl (11)
- # clojure-spec (54)
- # clojure-uk (115)
- # clojurescript (33)
- # core-async (4)
- # cursive (95)
- # datomic (27)
- # duct (1)
- # emacs (58)
- # figwheel (22)
- # figwheel-main (63)
- # garden (1)
- # graphql (10)
- # hyperfiddle (1)
- # leiningen (1)
- # luminus (6)
- # off-topic (12)
- # planck (7)
- # portkey (1)
- # quil (3)
- # re-frame (3)
- # reagent (5)
- # ring-swagger (3)
- # shadow-cljs (34)
- # slack-help (19)
- # spacemacs (57)
- # testing (2)
- # timbre (2)
- # tools-deps (42)
- # yada (6)
@martinklepsch I finally got to watch your cljdoc talk, very nice!
Thanks @cfleming 🙂
(sorry, I should have watched your talk live rather than blabbing in the hallway, then I could have asked intelligent questions in person 🙂 )
There was no time for questions so you did everything right 😄
> Have you thought about cross-linking libraries like crossclj did? I have and it's certainly a cool thing to have but for now I wanted to focus on something that helps with "How do I use this library?" and a code-explorer felt a bit too tangential to this for now
Yeah, I can see that. I think there’s a bunch of useful stuff you could do there long term though.
I can see that it would enable a bunch of interesting things, yeah... do you have anything particular in mind?
Minimising dependencies, for one thing - if I only use this one function from this lib, do I need all its deps?
Which is along the lines of what Rich and Alex seem to be working towards, so perhaps wait and see what they come up with.
Another thing which has been useful for me is “show me usage examples of this fn/macro”
That relies on you indexing lots of stuff though, so that you have a lot of usages to find.
I'm using Markdown + codox style wikilinks
Nice, I’m planning to support that in Cursive too. That sounds like a standard to me!
sweet!
Have you had problems with any docstrings rendering strangely if they’re not written with MD in mind?
> Minimising dependencies, for one thing - if I only use this one function from this lib, do I need all its deps? While useful my gut feeling is that this problem is only relevant to fairly few and advanced devs so overall impact might be low
Not trying to reject good ideas here but I have to pick my battles and so far I've tried to be guided by maximising impact and focusing on people at the lower end of the learning curve
> i.e. do you try to detect at all if a ns is actually using it? No, intentionally rendering everything as markdown so people just start using it
agree. Maybe I'll add a link to crossclj for that
there are situations where people have a code block that's indented 2 spaces, which subsequently looks broken
Anyway, it all looks awesome. I love the clj/s rendering too, I’ve been meaning to do that for ages in Cursive.
There recently was a button introduced to render docstrings as raw monospaced text, that's supposed to mitigate this problem somewhat while sticking to the principle of assuming markdown
how do you do static analysis in cursive, for macros and stuff? I seem to remember you mentioning it in a talk but can’t find anything else
@tavistock I’ve pretty much only described it in talks, and in discussions on issues etc. Basically I define grammars for macro forms, and then extensions to handle the parsed forms in various ways. The grammars describe how to capture various elements and then the extensions interpret the captured data.
I’m planning to open source all that so that users and library authors can add support for libs they write or use to Cursive, but unfortunately due to some bad early decisions that’s proving difficult.
@dominicm what are you talking about? 😄
I really want to standardize those in Clojure docstrings. For entirely selfish reasons. It's a shame there's no real standards on this.
I don't even know what this is 😄
Hi, a noob question: in the readme is a more REPL-driven workflow mentioned. So far I only tried lein or boot to do that. How could I start a repl in the cljdoc.server.system
namespace using clj
? Thank you 🙂
You run clj
and move into that namespace (after requiring it) using in-ns
. Then you can evaluate the forms in the comment block at the end
Offline for a bit now but maybe other folks in here can help further if needed :)
Thanks so much. The step I was missing was requiring the namespace before moving into it. Almost 😄 Working great now! If you don't mind I would send a small PR to mention this in the readme.
I’ve actually noticed today that the „running cljdoc locally“ file should also describe the repl workflow. If you feel like it you Code also add this there alongside the basic note from the reader
Readme