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

Clarify a couple intro points #348

Closed
SeanTAllen opened this issue Feb 11, 2019 · 2 comments · Fixed by #529
Closed

Clarify a couple intro points #348

SeanTAllen opened this issue Feb 11, 2019 · 2 comments · Fixed by #529
Assignees
Labels
good first issue Good for newcomers

Comments

@SeanTAllen
Copy link
Member

In the intro to the tutorial, we mention that Pony is deadlock-free.

After watching https://www.twitch.tv/videos/378865137, I think its reasonable to assume that many people will interpret that was "livelock" free as well. A short clarification of that would make sense.

From the video, I think it also behooves us to expand a bit on "data race free" as it relates to concurrent access to memory as compared to "you wrote your algo wrong".

@rhagenson rhagenson added the good first issue Good for newcomers label Dec 16, 2020
@rhagenson
Copy link
Member

@SeanTAllen The video you linked in this issue is no longer available. Do you recall the video, and are you able to find an alternative link?

I see this issue as needing someone outside Pony as it a kind of "mismatched expectations" issue. After reading the Introduction content, what does a new reader later realize was misleading?

Short list of points of clarification:

  • Deadlock-free is not livelock-free
  • Better explain data race free as seen in Pony

I also would like to get outside perspective on how we can make this first page a better bottom-line for Pony. For example, I think the "Guiding Principles" can be almost entirely removed, but I am too far removed from knowing if it contains useful information for new readers. (My thought on this is the "Guiding Principles" is too explicit a list for someone first arriving to Pony and is better expressed throughout the Tutorial as motivation for design elements.)

@SeanTAllen
Copy link
Member Author

It was someone learning pony and recording it. Beyond that, I don't remember

@SeanTAllen SeanTAllen added the help wanted Extra attention is needed label Feb 8, 2022
SeanTAllen added a commit that referenced this issue Jan 28, 2024
@SeanTAllen SeanTAllen removed the help wanted Extra attention is needed label Jan 28, 2024
@SeanTAllen SeanTAllen self-assigned this Jan 28, 2024
SeanTAllen added a commit that referenced this issue Jan 28, 2024
SeanTAllen added a commit that referenced this issue Jan 28, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
good first issue Good for newcomers
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants