jafingerhut.github.com icon indicating copy to clipboard operation
jafingerhut.github.com copied to clipboard

A Big Thanks!

Open twashing opened this issue 4 years ago • 8 comments

Not an issue really. Just dropped in to say that the Clojure Cheatsheet with TipTip is my goto documentation.

So a big thanks to all contributors. And let me / us know if there's any way to support your work.

Cheers Tim

twashing avatar Jul 12 '20 14:07 twashing

Glad you like it!

It is fairly low maintenance work these days, with occasional bursts of additions when a new release of Clojure comes out.

I know it does not contain everything included with Clojure. I could imagine adding a few more things to it that aren't there already, but it isn't clear to me what the most important things are that are left out.

jafingerhut avatar Jul 12 '20 15:07 jafingerhut

Right right. Well I'll keep my eyes peeled as to any docs that could be added.

Thanks again!

Tim Washington Interruptsoftware.com http://interruptsoftware.com 415.283.8889

On Sun, Jul 12, 2020 at 11:34 AM Andy Fingerhut [email protected] wrote:

Glad you like it!

It is fairly low maintenance work these days, with occasional bursts of additions when a new release of Clojure comes out.

I know it does not contain everything included with Clojure. I could imagine adding a few more things to it that aren't there already, but it isn't clear to me what the most important things are that are left out.

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub https://github.com/jafingerhut/jafingerhut.github.com/issues/10#issuecomment-657238179, or unsubscribe https://github.com/notifications/unsubscribe-auth/AAB2RKDOWVALT3O2FNG44ALR3HJX5ANCNFSM4OX2ZHNQ .

twashing avatar Jul 12 '20 15:07 twashing

Here is a list of Clojure Vars (functions, macros, and others) that are in the namespaces used by the cheat sheet generator program, but not currently included in the cheat sheet. I would not want to include them all, since some are fairly esoteric in their use, but I would not be surprised if some of them would be useful to add: https://github.com/jafingerhut/clojure-cheatsheets/blob/master/src/clj-jvm/unused-symbols.txt

jafingerhut avatar Jul 13 '20 00:07 jafingerhut

Oh, very interesting. Things like clojure.core.async.impl.protocols/closed? Available but not meant to be publicly consumed?

I could see that being very useful. Maybe under a Miscellaneous section, or something.

Tim Washington Interruptsoftware.com http://interruptsoftware.com 415.283.8889

On Sun, Jul 12, 2020 at 8:41 PM Andy Fingerhut [email protected] wrote:

Here is a list of Clojure Vars (functions, macros, and others) that are in the namespaces used by the cheat sheet generator program, but not currently included in the cheat sheet. I would not want to include them all, since some are fairly esoteric in their use, but I would not be surprised if some of them would be useful to add: https://github.com/jafingerhut/clojure-cheatsheets/blob/master/src/clj-jvm/unused-symbols.txt

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub https://github.com/jafingerhut/jafingerhut.github.com/issues/10#issuecomment-657302423, or unsubscribe https://github.com/notifications/unsubscribe-auth/AAB2RKH7MROYE6MSPMVND7DR3JJ2LANCNFSM4OX2ZHNQ .

twashing avatar Jul 13 '20 17:07 twashing

There is little or nothing about the core.async library in the cheat sheet right now. In general, if something is there, it is good if it can have some kind of at least rough categorization of it, and yes, implementation details are best not included, I think.

jafingerhut avatar Jul 13 '20 17:07 jafingerhut

Yes, agreed. Right now, Clojuredocs has my goto documentation for core.async .

  • https://clojuredocs.org/clojure.core.async

Tim Washington Interruptsoftware.com http://interruptsoftware.com 415.283.8889

On Mon, Jul 13, 2020 at 1:22 PM Andy Fingerhut [email protected] wrote:

There is little or nothing about the core.async library in the cheat sheet right now. In general, if something is there, it is good if it can have some kind of at least rough categorization of it, and yes, implementation details are best not included, I think.

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub https://github.com/jafingerhut/jafingerhut.github.com/issues/10#issuecomment-657687324, or unsubscribe https://github.com/notifications/unsubscribe-auth/AAB2RKHZHV4F3XMRGIUPEGDR3M7E3ANCNFSM4OX2ZHNQ .

twashing avatar Jul 13 '20 17:07 twashing

I don't even write Clojure, but I have to say I am really impressed with the UI for this documentation. Well done!

lkdm avatar Oct 29 '22 20:10 lkdm

Thanks. Some of the contributors to the project are as responsible for the UI as I am, but glad to hear you like it. The code that produced it is all included and open source, so should not be difficult to reproduce for other documentation projects if you are interested.

jfingerh avatar Oct 31 '22 02:10 jfingerh