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

Thinking in Effection page and reorganize page #846

Merged
merged 14 commits into from
Dec 15, 2023
Merged

Conversation

taras
Copy link
Member

@taras taras commented Dec 13, 2023

Motivation

We want to give people what they need to know to start Effection.

Approach

Create "Thinking in Effection" page and moved Async Roseta Stone to that page.

Preview

https://effection--tm-reoganize-sections.deno.dev/docs/thinking-effection

Questions

  • I'm not happy with the example in Every function returns or throws section. It can be said that the same can be accomplished with async await.

@taras taras marked this pull request as draft December 13, 2023 20:25
@cowboyd
Copy link
Member

cowboyd commented Dec 14, 2023

How about this as an intro?

When we say that Effection is "Structured Concurrency and Effects for Javascript" we mean three things:

  1. No operation runs longer than its parent.
  2. Every operation exits fully.
  3. It's just JavaScript, and except for the guarantees derived from (1) and (2), it should feel familiar in every other way.

Developing a new intuition about how to leverage Structured Concurrency, while leaning on your existing intuition as a JavaScript developer will help you get the most out of Effection and have you attempting things that you would never have even dreamed anymore.

@taras
Copy link
Member Author

taras commented Dec 14, 2023

  1. No operation runs longer than its parent.
  2. Every operation exits fully.
  3. It's just JavaScript, and except for the guarantees derived from (1) and (2), it should feel familiar in every other way.

Are these the "Three Laws of Structured Concurrency with Effection"?

@taras taras marked this pull request as ready for review December 14, 2023 21:21
@taras taras changed the title Adding draft of Thinking in Effection page Thinking in Effection page and reorganize page Dec 15, 2023
@cowboyd
Copy link
Member

cowboyd commented Dec 15, 2023

I'd remove the .gif if it isn't going to be used

@taras taras merged commit 4fa896a into v3 Dec 15, 2023
3 checks passed
@taras taras deleted the tm/reoganize-sections branch December 15, 2023 22:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants