WIP: Add Node.js to Perl 6 nutshell page #1975

Kaiepi · 2018-04-29T08:23:40Z

DO NOT MERGE YET

Just looking for some feedback as I write the page.

Fixes #1968

Tyil · 2018-04-30T05:10:57Z

doc/Language/js-nutshell.pod6

+
+=SUBTITLE Learning Perl 6 from Node.js, in a nutshell.
+
+This page attempts to provide a way for users experienced in Node,js to learn


Node,js should be using a . instead of a ,.

There is no comma in Node.js here

This page attempts to provide a way for users experienced in Node,js to learn

Node,js

I'm pretty sure the exact line I referenced contains a , right there.

It's in line 7, experienced in node,js

Tyil · 2018-04-30T05:13:34Z

doc/Language/js-nutshell.pod6

+In Perl 6, there are two ways to write this in the same way:
+
+=begin code
+put 'Hello, world!';


The documentation on say comes with this line

Prints value to $*OUT after stringification using gist method with newline at end. To produce machine readable output use .put.

I'd consider using say in your examples, since this is the most commonly used (from what I gather in #perl6, that is).

since this is the most commonly used (from what I gather in #perl6, that is)

Whether you use one or another depends on your intent (but yes, most examples should probably use say)

Tyil · 2018-04-30T05:14:57Z

doc/Language/js-nutshell.pod6

+console.log('Hello, world!');
+=end code
+
+In Perl 6, there are two ways to write this in the same way:


There are many more, actually. Like say.

Tyil · 2018-04-30T05:17:42Z

doc/Language/js-nutshell.pod6

+say "What's up, " ~ $name ~ "?";
+say "What's up, $name?";
+say "What's up, ", $name, "?";
+=end code


You're showing different quote styles in the Javascript example, one without interpolation and one with interpolation. Why not do the same for Perl 6, ie: single quotes and double quotes?

Tyil · 2018-04-30T05:19:42Z

doc/Language/js-nutshell.pod6

+This is how the equivalent types of variables are defined in Perl 6:
+
+=begin code
+my $foo = 1;      // Lexically scoped with blocks


» perl6 -e 'my $foo = 1; // Lexically scoped with blocks' ===SORRY!=== Error while compiling -e Null regex not allowed at -e:1 ------> my $foo = 1; //⏏ Lexically scoped with blocks

Perl 6 uses # to start a comment, not //.

Kaiepi · 2018-05-02T00:59:00Z

Updated

JJ

Please check also the test error and try to fix it in your next commit.

JJ · 2018-04-29T08:32:27Z

doc/Language/js-nutshell.pod6

+Since he didn't hear us, let's greet him again, this time in Perl 6:
+
+=begin code
+my $name := 'Joe';


Is let binding? If it's not, it's better to just use =

Did you have a look at this?

let is not binding in Javascript, let makes it a block scope local variable.

JJ · 2018-04-29T08:33:39Z

doc/Language/js-nutshell.pod6

+logDupe(2); // 2
+=end code
+
+Perl 6 also allows this:


I can't see it clearly here, but we're using the unicode character non-breaking space for the space before 6. If you've done so, no problem.

* is not, per se, a twigil; $* together are the twigil.

JJ · 2018-04-29T08:35:10Z

doc/Language/js-nutshell.pod6

+console.log('Hello, world!');
+=end code
+
+In Perl 6, there are two ways to write this in the same way:


Well, there's "say" too... Maybe this example should include printing of variables, and how that is done in Perl using dd

I don't think we should show off dd as being a Perl 6 feature, as dd is a Rakudo specific feature.

Kaiepi · 2018-05-16T23:29:09Z

Updated, corrected some parts of the basic syntax section that were incorrect

Tyil · 2018-05-17T06:38:12Z

doc/Language/js-nutshell.pod6

+
+=SUBTITLE Learning Perl 6 from Node.js, in a nutshell.
+
+This page attempts to provide a way for users experienced in Node,js to learn


I know you've told me twice already that you don't see a comma here, but it still reads Node,js.

Whoops, thought I got that in the last commit

Tyil · 2018-05-17T06:41:17Z

doc/Language/js-nutshell.pod6

+    let foo = 2;
+    console.log(foo);
+}
+logDupe(2); // 2


Maybe add console.log(foo) here to show that the original foo declared before the function is unaffected.

Tyil · 2018-05-17T06:41:43Z

doc/Language/js-nutshell.pod6

+    my $foo = 2;
+    say $foo;
+}
+log-dupe; # 2


Maybe add a say $foo here to show that the original $foo declared before the sub is unaffected.

Tyil · 2018-05-17T06:43:57Z

doc/Language/js-nutshell.pod6

+The C<=> operator works the same across both languages.
+
+The C<:=> operator in Perl 6 binds a value to a variable. This makes it so the
+variable can't be reassigned. Binding a variable to another variable gives them


the variable can't be reassigned.

Oh? Afaik := just binds the value directly to the variable, but you can still reassign the variable:

> my $a := 5; $a := 4; say $a; 4

Tyil · 2018-05-17T06:45:01Z

doc/Language/js-nutshell.pod6

+my %bound := %map;
+%map<foo> = 'bar';
+say %bound;        # {foo => bar}
+=end code


Can you show how a regular hash would look like, if it were assigned with =? This would make it more clear to see the differences between assignment done with = and :=.

Fixes Raku#1968

Kaiepi · 2018-05-21T00:45:18Z

Updated with documentation on operators

JJ · 2018-05-21T05:10:06Z

Please check the POD error and fix it.

JJ · 2018-05-21T05:11:48Z

I think that come a certain point, it's better to accept it so that anyone can work on it. It's better to have something there than to have something perfect.

Kaiepi · 2018-05-21T12:31:30Z

Please check the POD error and fix it.

Done

I think that come a certain point, it's better to accept it so that anyone can work on it. It's better to have something there than to have something perfect.

I think this is a good idea. The rest of the first section is relatively straightforward to write, but the later ones are too complex to write comprehensive documentation for alone

JJ

I'm aproving this as it is now, and leave the rest for future improvements. The areas are well marked, and anyone can work on them now. I'll create an issue to that effect.

Kaiepi force-pushed the nodejs branch from 62cac59 to e1211df Compare April 29, 2018 08:30

Tyil reviewed Apr 30, 2018

View reviewed changes

Tyil changed the title ~~Add Node.js to Perl 6 nutshell page~~ WIP: Add Node.js to Perl 6 nutshell page Apr 30, 2018

Kaiepi force-pushed the nodejs branch from e1211df to 011b4ec Compare May 2, 2018 00:58

JJ reviewed May 3, 2018

View reviewed changes

Kaiepi force-pushed the nodejs branch 2 times, most recently from 584ad81 to 6af128f Compare May 16, 2018 23:28

Tyil requested changes May 17, 2018

View reviewed changes

Kaiepi force-pushed the nodejs branch 6 times, most recently from cdffe91 to e0d3509 Compare May 17, 2018 18:17

Add Node.js to Perl 6 nutshell page

03ba410

Fixes Raku#1968

Kaiepi force-pushed the nodejs branch from e0d3509 to 03ba410 Compare May 17, 2018 18:17

Kaiepi force-pushed the nodejs branch 4 times, most recently from d2930af to 91b1a70 Compare May 21, 2018 00:54

Add operators documentation

d07dbce

Kaiepi force-pushed the nodejs branch from 91b1a70 to d07dbce Compare May 21, 2018 12:26

JJ approved these changes May 21, 2018

View reviewed changes

JJ merged commit 343c127 into Raku:master May 21, 2018

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

WIP: Add Node.js to Perl 6 nutshell page #1975

WIP: Add Node.js to Perl 6 nutshell page #1975

Kaiepi commented Apr 29, 2018

Tyil Apr 30, 2018

Kaiepi May 2, 2018

Tyil May 2, 2018 •

edited

JJ May 3, 2018

Tyil Apr 30, 2018

AlexDaniel Apr 30, 2018 •

edited

Tyil Apr 30, 2018

Tyil Apr 30, 2018

Tyil Apr 30, 2018

Kaiepi commented May 2, 2018

JJ left a comment

JJ Apr 29, 2018

JJ May 3, 2018

Tyil May 4, 2018

JJ Apr 29, 2018

JJ May 3, 2018

JJ Apr 29, 2018

Tyil May 4, 2018

Kaiepi commented May 16, 2018

Tyil May 17, 2018

Kaiepi May 17, 2018

Tyil May 17, 2018

Tyil May 17, 2018

Tyil May 17, 2018

Tyil May 17, 2018

Kaiepi commented May 21, 2018

JJ commented May 21, 2018

JJ commented May 21, 2018 via email

Kaiepi commented May 21, 2018

JJ left a comment


		=SUBTITLE Learning Perl 6 from Node.js, in a nutshell.

		This page attempts to provide a way for users experienced in Node,js to learn

WIP: Add Node.js to Perl 6 nutshell page #1975

WIP: Add Node.js to Perl 6 nutshell page #1975

Conversation

Kaiepi commented Apr 29, 2018

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Tyil May 2, 2018 • edited

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

AlexDaniel Apr 30, 2018 • edited

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

Kaiepi commented May 2, 2018

JJ 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

Kaiepi commented May 16, 2018

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

Kaiepi commented May 21, 2018

JJ commented May 21, 2018

JJ commented May 21, 2018 via email

Kaiepi commented May 21, 2018

JJ left a comment

Choose a reason for hiding this comment

Tyil May 2, 2018 •

edited

AlexDaniel Apr 30, 2018 •

edited