Fork me on GitHub
#reagent
<
2017-06-04
>
juhoteperi11:06:01

Also, I'd recommend not using react-with-addons as it is deprecated and the next React version will drop it completely, instead the addons are now provided as separate packages: https://github.com/cljsjs/packages/tree/master/react-transition-group

marctrem19:06:24

Hello, where could I find documentation about what [:> ...] does? Thanks!

noisesmith19:06:04

it's a sugar for adapt-react-class which should be googlable

pesterhazy19:06:02

man, this question comes up so often, it would be so useful to have better (additional, unofficial?) reagent docs

gadfly36119:06:47

@pesterhazy I think a minimal solution would be to add links in the reagent README with each news article and then list out the key terms .. something like:

News 0.5.0
 - adapt-react-class
 - :>
 - ...

gadfly36119:06:04

but i wont discourage anyone who wants to take time to actually improve the docs! everyone benefits when that happens

pesterhazy19:06:37

The only problem with that is that people aren't actually interested in the chronological history of the project

gadfly36119:06:03

yeah, that's fair

pesterhazy19:06:13

Maybe better to sort the feature by topic?

pesterhazy19:06:47

E.g.

React intertop
 - adapt-react-class
 - :>
 - as/element

pesterhazy19:06:33

State tracking
  - ratoms
  - track
  - track!
  - reactions
  - cursors

gadfly36119:06:21

I like it! if a good organization of topics emerges ... the cookbook could also spell out examples for each thing too to supplement

pesterhazy19:06:44

who's maintaining the readme these days?

gadfly36119:06:53

for reagent itself, a number of us (@yogthos @mikethompson etc.) would be comfortable accepting PRs for the README to improve documentation I think. As for the cookbook, I maintain that (just haven't done much in a while)

noisesmith19:06:39

if only keywords could have doc metadata, being able to run (doc :>) would have handy

noisesmith19:06:59

(but that doesn't quite work because really anyone can use that keyword for anything...)

pesterhazy19:06:09

I think reorganizing the docs would be pretty useful and doable

pesterhazy19:06:25

Even just a better TOC would be great

marctrem19:06:32

I’ve been using the re-frame/reagent combo for quite some time and I had no idea that track was a thing. Just looked it up. Thanks! I’ll have to read the changelist to get up-to-date 😛

pesterhazy19:06:29

track is super handy 🙂

marctrem20:06:28

I still don’t se what it provides over re-frame subscriptions that are subscribed to other subscriptions. From what I understand, you get the same thing out of both. Am I wrong?

pesterhazy20:06:51

track is like a subscription, yup

pesterhazy20:06:59

but doesn't require re-frame

pesterhazy20:06:10

it's essentially a nice way to create a reaction

marctrem20:06:53

Got it! Thank you very much! 💯

pesterhazy20:06:04

Alright, I've created a "wishlist" issue with a list of topics: https://github.com/reagent-project/reagent/issues/302