List.rotate returns a Seq since Rakudo 2020.06

ref #3495

While here flesh out a bit the routine description and adopt a more
common example style.

Author: stoned

doc/Type/List.pod6

@@ -800,15 +800,19 @@ Examples:
 
 Defined as:
 
-    multi sub    rotate(@list,  Int:D $n = 1 --> List:D)
-    multi method rotate(List:D: Int:D $n = 1 --> List:D)
+    multi sub    rotate(@list,  Int:D $n = 1 --> Seq:D)
+    multi method rotate(List:D: Int:D $n = 1 --> Seq:D)
 
-Returns the list rotated by C<$n> elements.
+Returns a L«C<Seq>|/type/Seq» with the list elements rotated to the left
+when C<$n> is positive or to the right otherwise.
 
 Examples:
 
-    <a b c d e>.rotate(2);   # <c d e a b>
-    <a b c d e>.rotate(-1);  # <e a b c d>
+    say <a b c d e>.rotate(2);   # OUTPUT: (c d e a b)
+    say <a b c d e>.rotate(-1);  # OUTPUT: (e a b c d)
+
+B<Note>: Before Rakudo version 2020.06 a new C<List> was returned instead
+of a C<Seq>.
 
 =head2 routine sort