News for hackers. Stuff that matters.
Re:Re-Frame: Build web apps in ClojureScript and React by MikeOfAu on Sunday July 26, 2020 @06:00AM (#23955852)
Well, I'm glad to hear it might have improved. After taking a battering in this thread, I'll take any possible small win.

What you reference is an attempt at a joke which requires certain cultural knowledge (Early Star Trek). On this point, I'm probably unlikely to change, and will just have to ask for your forgiveness. I like my docs to have an occasional joke, whether I'm the reader or the writer. But I am aware that this is not everyone's cup of tea (English cultural reference).

Re:Re-Frame: Build web apps in ClojureScript and React by hellofunk on Sunday July 26, 2020 @06:47AM (#23956063)
The re-frame docs and "marketing" speak, like on its front github page, would do very well to remove a lot of the self-congratulatory tone, frankly. A lot of it reads like someone very impressed with themselves rather than text about how to use an actual tool.
Re:Re-Frame: Build web apps in ClojureScript and React by MikeOfAu on Sunday July 26, 2020 @07:11AM (#23956183)
Thanks, I'll keep that in mind.
Re:Re-Frame: Build web apps in ClojureScript and React by ISO-morphism on Sunday July 26, 2020 @11:39AM (#23957849)
I really like the re-frame docs, thank you very much for putting so much effort into them. They've helped me grow as a programmer. For context, I first stumbled across the readme in ~2015-16 in college before working professionally. As someone looking to learn I enjoyed the didactic bent, I felt like I got the big picture. It tied together a lot of Clojure kool-aid.

The vibe I get from the tone of the docs isn't really juvenile or self-congratulatory. The humor is mature, references made show that material therein have been considered. It's not memes and emojis and WOW! It's somewhat unprofessional, has a few in-jokes, but I like those signals. If the docs haven't succumbed to design-by-committee lowest-common-denominator then neither has the code. It gives me the feeling that someone took the slow road, thought about a lot of things, came out with something simple, and is likely to work hard to preserve that simplicity.

The docs tell me that re-frame is focused on the craft. That means a lot more to me than sprinting to see how do I do x in y quickly.

Re:Re-Frame: Build web apps in ClojureScript and React by rlander on Sunday July 26, 2020 @09:34AM (#23956952)
Please don’t listen to the peanut gallery. The re-frame docs are in a league of their own and most of us appreciate the enormous effort put in to make them awesome. Keep rocking.
Re:Re-Frame: Build web apps in ClojureScript and React by MikeOfAu on Sunday July 26, 2020 @10:38AM (#23957354)
Oh Man, it is certainly nice to hear something positive. Thanks!
Re:Re-Frame: Build web apps in ClojureScript and React by frompdx on Sunday July 26, 2020 @03:20PM (#23959440)
The docs are great and re-frame is a pleasure to work with. It make take some time to read through the docs but it is a worthwhile endeavor as the concepts build upon each other. They reward those willing to take the time. When I was a newcomer to re-frame and cljs I did not find the re-frame docs to be pretentious or off putting in any way. If not for re-frame and the re-frame docs I'm not certain I would have continued to use Clojure or cljs. Thank you for building this excellent tool and providing high quality documentation to back it.
Re:Re-Frame: Build web apps in ClojureScript and React by rboyd on Sunday July 26, 2020 @08:15AM (#23956529)
the re-frame docs are great, never change
Re:Re-Frame: Build web apps in ClojureScript and React by MikeOfAu on Sunday July 26, 2020 @09:29AM (#23956915)
I appreaciate you saying that, thanks.
Re:Re-Frame: Build web apps in ClojureScript and React by harperlee on Monday July 27, 2020 @04:25AM (#23963192)
Well I tried to write a balanced comment and try not to hurt but it seems I failed. As I said, the content was good; and I did not say it but I would kill for that level of docs in every open source project. So sorry if I hit your emotions and thanks for your work!!