Some work on py-nutshell.rakudoc

doc/Language/py-nutshell.rakudoc

@@ -32,7 +32,7 @@ Raku
     put "Hello, world!"
 
 There is also the L<say|/routine/say> keyword, which behaves similarly, but will
-call the L<gist|/routine/gist> method of its argument.
+call the L<.gist|/routine/gist> method of its argument instead of the C<.Str|/routine/Str> method.
 
 Raku
 
@@ -64,8 +64,9 @@ matching curly braces are closed.
 
 In Raku, a semicolon signifies the end of a statement.
 The semicolon may be omitted if it is the last statement
-of a block. The semicolon may also be omitted if there
-is a closing curly brace followed by a newline.
+of a block (i.e. of a list of statements enclosed in curly braces).
+The semicolon may also be omitted after a closing curly brace
+followed by a newline.
 
 Python
 
@@ -81,6 +82,7 @@ Raku
         3 + 4;
     say 1 +
         2;
+    if True { say 42 }
 
 =head2 Blocks
 
@@ -123,7 +125,7 @@ initialized or declared and initialized at once.
     $foo = 12;     # initialize
     my $bar = 19;  # both at once
 
-Also, as you may have noticed, variables in Raku usually start with sigils --
+Also, as you may have noticed, variables in Raku usually start with sigils –
 symbols indicating the type of their container. Variables starting with a C<$>
 hold scalars. Variables starting with an C<@> hold arrays, and variables
 starting with a C<%> hold a hash (dict). Sigilless variables, declared with a
@@ -398,20 +400,23 @@ I<Raku>
         say "Symbol '$symbol' stands for $element";
     }
 
-=head2 Lambdas, functions and subroutines>
+=head2 Functions, subroutines and lambdas
 
 Declaring a function (subroutine) with C<def> in Python is accomplished
 with C<sub> in Raku.
 
 =begin code :lang<python>
 def add(a, b):
     return a + b
+=end code
 
+=begin code
 sub add(\a, \b) {
     return a + b
 }
 =end code
 
+
 The C<return> is optional; the value of the last expression is used as
 the return value:
 
@@ -431,8 +436,8 @@ sub add($a, $b) {
 Python 2 functions can be called with positional arguments
 or keyword arguments.  These are determined by the caller.
 In Python 3, some arguments may be "keyword only".
-In Raku, positional and named arguments are determined
-by the signature of the routine.
+In Raku, each argument is either positional or named,
+as determined by the signature of the routine.
 
 Python
 
@@ -827,4 +832,23 @@ Raku using the List type, or from an external module.
     my $list4 = (|$list1, |$list2);                # equivalent to previous line
     say $list3;                                    # OUTPUT: «(1, two, 3, hat, 5, 6, seven)␤»
 
+=head1 Ecosystem
+
+Where Python has pip, anaconda or uv, Raku has zef as its preferred tool for module management.
+
+Where Python has PyPi, Raku has <raku.land|https://raku.land/>
+as the central index of third-party L<modules|/language/modules>.
+There are modules from three different ecosystems –
+please stick to the I<zef> ecosystem.
+(The others, I<p6c> and I<CPAN>, are deprecated when it comes to Raku.)
+See L<here|https://deathbyperl6.com/faq-zef-ecosystem/> for additional information,
+including guidance on how to publish your own modules.
+
+=head2 Web development
+
+The Raku module L<Cro|https://raku.land/zef:cro/cro> serves a similar job as Python's L<Django|https://djangoproject.com/>.
+
+The Raku module L<Red|https://raku.land/zef:FCO/Red> is an object–relational mapper, similar to Django's ORM capabilities or to SQLAlchemy.
+
 =end pod
+