Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add "wrapping it up" end for Capabilities chapter #70

Open
SeanTAllen opened this issue Apr 3, 2016 · 1 comment
Open

Add "wrapping it up" end for Capabilities chapter #70

SeanTAllen opened this issue Apr 3, 2016 · 1 comment
Labels
help wanted Extra attention is needed

Comments

@SeanTAllen
Copy link
Member

Need to write a last section to chapter 5; a section that brings it all together with examples. And a big picture view of how this all fits into good pony code. Its hard to know "what does this all mean" from the individual sections that detail parts of capabilities.

@SeanTAllen SeanTAllen added the help wanted Extra attention is needed label Nov 4, 2017
@rhagenson
Copy link
Member

We do not have a unique Capabilities chapter now -- there are two: Reference Capabilities and Object Capabilities.

I assume (without looking at the tutorial content at the time of this issue) that originally it referred to refcaps not the object capabilities. I think a wrap up section to review the concepts would be a good addition. Not sure exactly how that would look, but I suspect a bookend via an applied example would be helpful.

Refcaps are difficult to explain and (un)fortunately I have read or devised more ways to teach/learn it than there are refcaps themselves. Refcaps definitely feel like the "once you get it, you get it" concept where use leads to understanding. If we do not proceed with the wrap up example route I think the alternative is to provide a list of common use cases and match them to a set of "good" refcaps. Example, we could have this wrap up be a miniature FAQ of sorts where we present concerns like "I have data I want to share among threads/actors where each thread/actor can make changes: Ah, you want an iso of sorts" and "I have data I calculated which will never change throughout execution: Ah, you want a val of sorts" and "I have data that is private and I will want periodic updates to it: Ah, you want a ref of sorts"

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
help wanted Extra attention is needed
Projects
None yet
Development

No branches or pull requests

2 participants