Fork me on GitHub
#re-frame
<
2022-05-22
>
dvingo16:05:52

the other day I asked about the inspiration for re-frame's implementation (specifically subscriptions). I found this http://day8.github.io/re-frame/historical/ which has the line: > We read up on https://github.com/pedestal/pedestal-app, http://facebook.github.io/flux/docs/overview.html#content, http://hoplon.io/, https://github.com/swannodette/om, early http://elm-lang.org/ and re-frame is the architecture that emerged. this provides some useful context. I was also perusing Vishal's dive into historical versions of re-frame https://www.youtube.com/watch?v=mDDQ7UTnpto which gave me the idea to look at the early docs of re-frame hoping to find more detail. And there I found some really good info: https://github.com/day8/re-frame/tree/v0.5.0#how-flow-happens-in-reagent I think the current history page is nice, but having this deep dive into how subscriptions are actually implemented with reactions would be really useful to have in the current docs as well. At some point in your re-frame journey you likely want to dive into the implementation, and yes the code is quite compact but having this narrative would be beneficial as well.

dvingo16:05:28

ooh woops it's already there http://day8.github.io/re-frame/flow-mechanics/#how-flow-happens-in-reagent 😅 "Intermediate 4, 5, & 6" and "Flow Mechanics" are not very obvious to me..

dvingo16:05:00

"Intermediate 4, 5 & 6" => "Reactive UI update" "Flow Mechanics" => "Subscription implementation" are how I think of these

dvingo15:05:18

I am not sure if threads get indexed by the slack backup - but in case this helps someone in the future (my future self included) there are some implementation details from the prior versions of re-frame that are not in the current documentation https://github.com/day8/re-frame/tree/v0.5.0#the-signal-graph signal graph, subscription implementation, reagent, reactions, reaction chain also check the reagent docs https://github.com/reagent-project/reagent/blob/master/doc/ManagingState.md

superstructor22:05:02

@U051V5LLP PRs to improve documentation are always welcome and considered on the merits of the changes proposed. CD is setup so as soon as a PR is merged it is live on the re-frame site.

dvingo13:05:22

Thanks @U0G75S29H good to know. I think the wording is on the "brand"/style of the docs, so I suppose you could argue either way on the labels..

superstructor20:05:18

Yep more in reference to if there are interesting impl details missing from the current documentation that you found useful in the link above and are still valid it would make sense to find a place for those in the new docs.