feat: Add reactive/INTRODUCTION_EN.md #41

AZ-0 · 2020-08-25T19:57:15Z

Translate reactive/INTRODUCTION_FR.md to english

fusetim

Some typos to fix. Good translation otherwise.

fusetim · 2020-08-26T09:15:04Z

reactive/INTRODUCTION_EN.md

+I like exploding things, so we'll talk about a cannon.
+Don't worry about the `(x)` right now, you will understand them later on…
+
+Let's suppose you happily go to Wallmart to buy a cannon. It's a high-tech cannon that can automagically recharge.


The Walmart company has only one "L" in its name

Suggested change

Let's suppose you happily go to Wallmart to buy a cannon. It's a high-tech cannon that can automagically recharge.

Let's suppose you happily go to Walmart to buy a cannon. It's a high-tech cannon that can automagically recharge.

fusetim · 2020-08-26T09:16:35Z

reactive/INTRODUCTION_EN.md

+
+## An explanation to rekindle lost hopes
+
+Looks like you have a bad karma, because I am gonna be mean~. So mean that I'll use complicated words right away: `Publisher`! (Are you fearing me now?)


I suppose it's a typo

Suggested change

Looks like you have a bad karma, because I am gonna be mean~. So mean that I'll use complicated words right away: `Publisher`! (Are you fearing me now?)

Looks like you have a bad karma, because I am gonna be mean. So mean that I'll use complicated words right away: `Publisher`! (Are you fearing me now?)

fusetim · 2020-08-26T09:22:31Z

reactive/INTRODUCTION_EN.md

+Don't worry about the `(x)` right now, you will understand them later on…
+
+Let's suppose you happily go to Wallmart to buy a cannon. It's a high-tech cannon that can automagically recharge.
+With your newfound super-duper cannon, you go back and `(1)` install it on a hill (locking on your boss), `(2)` gets the fuses batch, and `(3)` fire as many fuses as you want to throw cannonballs on your boss.


Suggested change

With your newfound super-duper cannon, you go back and `(1)` install it on a hill (locking on your boss), `(2)` gets the fuses batch, and `(3)` fire as many fuses as you want to throw cannonballs on your boss.

With your newfound super-duper cannon, you go back and `(1)` install it on a hill (locking on your boss), `(2)` gets the fuse batches, and `(3)` fire as many fuses as you want to throw cannonballs on your boss.

or

Suggested change

With your newfound super-duper cannon, you go back and `(1)` install it on a hill (locking on your boss), `(2)` gets the fuses batch, and `(3)` fire as many fuses as you want to throw cannonballs on your boss.

With your newfound super-duper cannon, you go back and `(1)` install it on a hill (locking on your boss), `(2)` gets the fuse batch, and `(3)` fire as many fuses as you want to throw cannonballs on your boss.

fusetim · 2020-08-26T09:24:27Z

reactive/INTRODUCTION_EN.md

+- You don't even know whether the cannon will throw enough cannonballs to match your explosion desires (Has it enough ammunition? Will it explode halfway?)
+- You hate your boss enough that you decided to dance whenever the cannon throws a cannonball.
+- You somehow decided to run if the cannon explodes. Thanks, Captain Obvious.
+- You have decided to go on strike if your boss is still dead and you are running out of cannonballs. And if the cannon hasn't exploded, otherwise you would have fled too far~


A typo supposedly + no-sense

Suggested change

- You have decided to go on strike if your boss is still dead and you are running out of cannonballs. And if the cannon hasn't exploded, otherwise you would have fled too far~

- You have decided to go on strike if your boss is still alive and you are running out of cannonballs. And if the cannon hasn't exploded, otherwise you would have fled too far.

fusetim · 2020-08-26T09:27:49Z

reactive/INTRODUCTION_EN.md

+// I didn't declare a lot of things, we are doing pseudocode here
+interface Me {
+	// When the cannon finished it's installation, it will notify us and we get an infinite batch of fuses.
+  // Just because it's the future.
+	void onPrepare(FuseBatch fuses);
+
+	// This is called whenever the cannon launches a cannonball toward your patron.
+	default void onNext(CannonBall ball) {
+		dance();
+	}
+
+	// This is called when the cannon of the future throws an uncaught runtime exception and explodes.
+  // Yes, the futuuuuuuuure still has runtime exceptions :'c
+	default void onError(Throwable t) {
+		runForYourLife();
+	}
+
+	// This is called when the cannon has no cannonball left to fire.
+	default void onComplete() {
+		if (boss.isAliveAndKicking())
+			timeToGoOnStrike();
+	}
+}
+
+interface FuseBatch {
+	// We kindly ask the cannon to launch `fuseAmount` cannonballs by firing as many fuses.
+	void fire(long fuseAmount);
+
+	// If you suddendly remember the inherent kindness of your boss, stow your cannon and try to cancel the cannonballs' throwing.
+  // You might miss some fuses though, trampling on them isn't exactly a precise method.
+	void cancel();
+}
+```


Weird alternance tab/space

Suggested change

// I didn't declare a lot of things, we are doing pseudocode here

interface Me {

// When the cannon finished it's installation, it will notify us and we get an infinite batch of fuses.

// Just because it's the future.

void onPrepare(FuseBatch fuses);

// This is called whenever the cannon launches a cannonball toward your patron.

default void onNext(CannonBall ball) {

dance();

}

// This is called when the cannon of the future throws an uncaught runtime exception and explodes.

// Yes, the futuuuuuuuure still has runtime exceptions :'c

default void onError(Throwable t) {

runForYourLife();

}

// This is called when the cannon has no cannonball left to fire.

default void onComplete() {

if (boss.isAliveAndKicking())

timeToGoOnStrike();

}

}

interface FuseBatch {

// We kindly ask the cannon to launch `fuseAmount` cannonballs by firing as many fuses.

void fire(long fuseAmount);

// If you suddendly remember the inherent kindness of your boss, stow your cannon and try to cancel the cannonballs' throwing.

// You might miss some fuses though, trampling on them isn't exactly a precise method.

void cancel();

}

```

// I didn't declare a lot of things, we are doing pseudocode here

interface Me {

// When the cannon finished it's installation, it will notify us and we get an infinite batch of fuses.

// Just because it's the future.

void onPrepare(FuseBatch fuses);

// This is called whenever the cannon launches a cannonball toward your patron.

default void onNext(CannonBall ball) {

dance();

}

// This is called when the cannon of the future throws an uncaught runtime exception and explodes.

// Yes, the futuuuuuuuure still has runtime exceptions :'c

default void onError(Throwable t) {

runForYourLife();

}

// This is called when the cannon has no cannonball left to fire.

default void onComplete() {

if (boss.isAliveAndKicking())

timeToGoOnStrike();

}

}

interface FuseBatch {

// We kindly ask the cannon to launch `fuseAmount` cannonballs by firing as many fuses.

void fire(long fuseAmount);

// If you suddendly remember the inherent kindness of your boss, stow your cannon and try to cancel the cannonballs' throwing.

// You might miss some fuses though, trampling on them isn't exactly a precise method.

void cancel();

}

fusetim · 2020-08-26T09:29:28Z

reactive/INTRODUCTION_EN.md

+
+```java
+interface Publisher<T> {
+  // We prepare the subscription, this might take some time


Replaced space by tab

Suggested change

// We prepare the subscription, this might take some time

// We prepare the subscription, this might take some time

fusetim · 2020-08-26T09:30:46Z

reactive/INTRODUCTION_EN.md

+  // • If the cumulated demand overflow the long max number, it can treat it as unbound, effectively turning into a hot source.
+  // (We'll see what this means in later sheets)
+	// • If the Publisher completes (cannot generate anymore element) or errors (sad life), it will call the related method then stop ANY further emission.
+ 	void request(long elementAmount);
+
+  // Asks the Publisher to cancel the subscription, that is to stop emitting elements.
+	// Previous pending requests might still be met.
+  void cancel();


Weird alternance space/tab

Suggested change

// • If the cumulated demand overflow the long max number, it can treat it as unbound, effectively turning into a hot source.

// (We'll see what this means in later sheets)

// • If the Publisher completes (cannot generate anymore element) or errors (sad life), it will call the related method then stop ANY further emission.

void request(long elementAmount);

// Asks the Publisher to cancel the subscription, that is to stop emitting elements.

// Previous pending requests might still be met.

void cancel();

// • If the cumulated demand overflow the long max number, it can treat it as unbound, effectively turning into a hot source.

// (We'll see what this means in later sheets)

// • If the Publisher completes (cannot generate anymore element) or errors (sad life), it will call the related method then stop ANY further emission.

void request(long elementAmount);

// Asks the Publisher to cancel the subscription, that is to stop emitting elements.

// Previous pending requests might still be met.

void cancel();

fusetim · 2020-08-26T09:32:21Z

reactive/INTRODUCTION_EN.md

+
+With this awesome list written by the great and humble me, you ought to understand the lil `(x)` scattered up there! (a retroactive sheet, progress cannot be halted)
+
+Let's stop there for a very small peek into reactive programming, I pray that your imagination run wild on its capabilities~


Typo I think

Suggested change

Let's stop there for a very small peek into reactive programming, I pray that your imagination run wild on its capabilities~

Let's stop there for a very small peek into reactive programming, I pray that your imagination run wild on its capabilities

Tran-Antoine · 2020-08-26T20:09:06Z

reactive/INTRODUCTION_EN.md

+
+## Definition
+
+The original article has the [french](https://fr.wikipedia.org/wiki/Programmation_r%C3%A9active) definition as well, but seeing as it is quite useless I just removed it.


Suggested change

The original article has the [french](https://fr.wikipedia.org/wiki/Programmation_r%C3%A9active) definition as well, but seeing as it is quite useless I just removed it.

The original article has the [french](https://fr.wikipedia.org/wiki/Programmation_r%C3%A9active) definition as well, but after judging that it was quite irrelevant, I just removed it.

Couldn't quite understand the but seeing as it is quite useless, I suggested an alternative

Tran-Antoine · 2020-08-26T20:12:09Z

reactive/INTRODUCTION_EN.md

+> With this paradigm it is possible to express static (e.g., arrays) or dynamic (e.g., event emitters) data streams with ease, and also communicate that an inferred dependency
+> within the associated execution model exists, which facilitates the automatic propagation of the changed data flow.
+
+Wow, that's a lot of cool and complicated words! Don't worry, at this point not feeling overwhelmed would be concerning.


Suggested change

Wow, that's a lot of cool and complicated words! Don't worry, at this point not feeling overwhelmed would be concerning.

Wow, that's a lot of cool and complicated words! Don't worry, at this point no overwhelming feeling would be concerning.

Tran-Antoine · 2020-08-26T20:26:56Z

reactive/INTRODUCTION_EN.md

+
+> Haha, I do not fear *anything*! A Publisher is something that publish other things, no?
+
+**EXACT!** Or rather, a Publisher emits things. A Publisher emits values, but specially so.


Suggested change

**EXACT!** Or rather, a Publisher emits things. A Publisher emits values, but specially so.

**EXACTLY!** Or rather, a Publisher emits things. A Publisher emits values but in a particular way.

Tran-Antoine · 2020-08-26T20:29:26Z

reactive/INTRODUCTION_EN.md

+> within the associated execution model exists, which facilitates the automatic propagation of the changed data flow.
+
+Wow, that's a lot of cool and complicated words! Don't worry, at this point not feeling overwhelmed would be concerning.
+(Or it just means you actually don't need this introduction at all so stop reading it and do something useful with your life)


I'm a big fan of light tone and jokes in articles, but I think this "and do something useful with your life" is kind of too much, unnecessary.

Tran-Antoine · 2020-08-26T20:30:45Z

reactive/INTRODUCTION_EN.md

+
+Looks like you have a bad karma, because I am gonna be mean~. So mean that I'll use complicated words right away: `Publisher`! (Are you fearing me now?)
+
+> Haha, I do not fear *anything*! A Publisher is something that publish other things, no?


Suggested change

> Haha, I do not fear *anything*! A Publisher is something that publish other things, no?

> Haha, I do not fear *anything*! A Publisher is something that publishes other things, no?

Tran-Antoine · 2020-08-26T20:40:00Z

reactive/INTRODUCTION_EN.md

+
+// I didn't declare a lot of things, we are doing pseudocode here
+interface Me {
+	// When the cannon finished it's installation, it will notify us and we get an infinite batch of fuses.


Suggested change

// When the cannon finished it's installation, it will notify us and we get an infinite batch of fuses.

// When the cannon finished its installation, it will notify us and we get an infinite batch of fuses.

Tran-Antoine · 2020-08-26T20:43:04Z

reactive/INTRODUCTION_EN.md

+```
+
+Well now that's done, we don't have anything else to do with our cannon.
+So let's haphazardly pick some code from [reactive-streams](http://www.reactive-streams.org/) since it should be related to the official topic of this sheet.


Suggested change

So let's haphazardly pick some code from [reactive-streams](http://www.reactive-streams.org/) since it should be related to the official topic of this sheet.

So let's haphazardly pick some code from [reactive-streams](http://www.reactive-streams.org/) since it should be related to the official topic of this article.

Tran-Antoine · 2020-08-26T20:44:01Z

reactive/INTRODUCTION_EN.md

+1. We order a subscription on Amazon Prime.
+1. We get the tailored subscription; note that it makes no sense for a person to have multiple subscriptions.
+1. We use the subscription to request objects to Amazon.
+1. These values will get there, eventually. And later. And might not arrive at all but usually they do (or I at least hope so). Amazon might even find itself out of stock!


Suggested change

1. These values will get there, eventually. And later. And might not arrive at all but usually they do (or I at least hope so). Amazon might even find itself out of stock!

1. These values will get there, eventually. And later. And might not arrive at all but usually, they do (or I at least hope so). Amazon might even find itself to be out of stock!

Tran-Antoine · 2020-08-26T20:44:25Z

reactive/INTRODUCTION_EN.md

+1. We use the subscription to request objects to Amazon.
+1. These values will get there, eventually. And later. And might not arrive at all but usually they do (or I at least hope so). Amazon might even find itself out of stock!
+
+With this awesome list written by the great and humble me, you ought to understand the lil `(x)` scattered up there! (a retroactive sheet, progress cannot be halted)


Suggested change

With this awesome list written by the great and humble me, you ought to understand the lil `(x)` scattered up there! (a retroactive sheet, progress cannot be halted)

With this awesome list written by the great and humble me, you ought to understand the lil `(x)` scattered up there! (a retroactive article, progress cannot be halted)

Tran-Antoine · 2020-08-26T20:53:14Z

reactive/README.md

+
+# Reactive Programming 🇪🇳
+
+This course is concerned about the reactive paradigm and its uses.


Suggested change

This course is concerned about the reactive paradigm and its uses.

This course focuses on the reactive paradigm and its uses.

the former formulation sounded pretty deprecated to me

AZ-0 added 2 commits August 25, 2020 21:44

fead: translate reactive/INTRODUCTION_FR.md to english

7023656

feat: add english side to reactive/README.md

383f469

LukaMrt added the translation Translation of existing feature label Aug 26, 2020

LukaMrt requested a review from Tran-Antoine August 26, 2020 07:58

fusetim reviewed Aug 26, 2020

View reviewed changes

Tran-Antoine requested changes Aug 26, 2020

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: Add reactive/INTRODUCTION_EN.md #41

feat: Add reactive/INTRODUCTION_EN.md #41

AZ-0 commented Aug 25, 2020

fusetim left a comment

fusetim Aug 26, 2020

fusetim Aug 26, 2020

fusetim Aug 26, 2020

fusetim Aug 26, 2020

fusetim Aug 26, 2020

fusetim Aug 26, 2020

fusetim Aug 26, 2020

fusetim Aug 26, 2020 •

edited

Loading

Tran-Antoine Aug 26, 2020

Tran-Antoine Aug 26, 2020

Tran-Antoine Aug 26, 2020

Tran-Antoine Aug 26, 2020

Tran-Antoine Aug 26, 2020

Tran-Antoine Aug 26, 2020

Tran-Antoine Aug 26, 2020

Tran-Antoine Aug 26, 2020

Tran-Antoine Aug 26, 2020

Tran-Antoine Aug 26, 2020

	Let's suppose you happily go to Wallmart to buy a cannon. It's a high-tech cannon that can automagically recharge.
	Let's suppose you happily go to Walmart to buy a cannon. It's a high-tech cannon that can automagically recharge.


		## An explanation to rekindle lost hopes

		Looks like you have a bad karma, because I am gonna be mean~. So mean that I'll use complicated words right away: `Publisher`! (Are you fearing me now?)

	With your newfound super-duper cannon, you go back and `(1)` install it on a hill (locking on your boss), `(2)` gets the fuses batch, and `(3)` fire as many fuses as you want to throw cannonballs on your boss.
	With your newfound super-duper cannon, you go back and `(1)` install it on a hill (locking on your boss), `(2)` gets the fuse batches, and `(3)` fire as many fuses as you want to throw cannonballs on your boss.

	- You have decided to go on strike if your boss is still dead and you are running out of cannonballs. And if the cannon hasn't exploded, otherwise you would have fled too far~
	- You have decided to go on strike if your boss is still alive and you are running out of cannonballs. And if the cannon hasn't exploded, otherwise you would have fled too far.

	// We prepare the subscription, this might take some time
	// We prepare the subscription, this might take some time


		With this awesome list written by the great and humble me, you ought to understand the lil `(x)` scattered up there! (a retroactive sheet, progress cannot be halted)

		Let's stop there for a very small peek into reactive programming, I pray that your imagination run wild on its capabilities~


		## Definition

		The original article has the [french](https://fr.wikipedia.org/wiki/Programmation_r%C3%A9active) definition as well, but seeing as it is quite useless I just removed it.

	Wow, that's a lot of cool and complicated words! Don't worry, at this point not feeling overwhelmed would be concerning.
	Wow, that's a lot of cool and complicated words! Don't worry, at this point no overwhelming feeling would be concerning.


		> Haha, I do not fear anything! A Publisher is something that publish other things, no?

		EXACT! Or rather, a Publisher emits things. A Publisher emits values, but specially so.

	EXACT! Or rather, a Publisher emits things. A Publisher emits values, but specially so.
	EXACTLY! Or rather, a Publisher emits things. A Publisher emits values but in a particular way.

	// When the cannon finished it's installation, it will notify us and we get an infinite batch of fuses.
	// When the cannon finished its installation, it will notify us and we get an infinite batch of fuses.

	So let's haphazardly pick some code from [reactive-streams](http://www.reactive-streams.org/) since it should be related to the official topic of this sheet.
	So let's haphazardly pick some code from [reactive-streams](http://www.reactive-streams.org/) since it should be related to the official topic of this article.

	1. These values will get there, eventually. And later. And might not arrive at all but usually they do (or I at least hope so). Amazon might even find itself out of stock!
	1. These values will get there, eventually. And later. And might not arrive at all but usually, they do (or I at least hope so). Amazon might even find itself to be out of stock!


		# Reactive Programming 🇪🇳

		This course is concerned about the reactive paradigm and its uses.

	This course is concerned about the reactive paradigm and its uses.
	This course focuses on the reactive paradigm and its uses.

feat: Add reactive/INTRODUCTION_EN.md #41

Are you sure you want to change the base?

feat: Add reactive/INTRODUCTION_EN.md #41

Conversation

AZ-0 commented Aug 25, 2020

fusetim left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

fusetim Aug 26, 2020 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

fusetim Aug 26, 2020 •

edited

Loading