Left only the COLLATION here, refs #1979

Author: JJ

doc/Language/experimental.pod6

@@ -28,56 +28,19 @@ not yet rendered properly.
 
 =head1 Collation
 
-Is available in release 2017.02. To use:
+The L<collate> and L<coll> are no longer experimental. However,
+these methods are affected by the X<B<$*COLLATION>|$*COLLATION>, which configures the four collation levels. While the Primary, Secondary and Tertiary mean different things for different scripts, for the Latin script used in English they mostly correspond with Primary being Alphabetic, Secondary being Diacritics and Tertiary being Case.
 
-    use experimental :collation;
-
-Allows the use of the X<B<unicmp>|unicmp, Routine> and X<B<coll>|coll, method> operators.
-Also allows the use of the X<B<collate>|collate> method. unicmp and coll are like cmp, except
-it implements the Unicode Collation Algorithm.
-
-B<coll> and the B<collate> method are affected by the X<B<$*COLLATION>|$*COLLATION>
-variable, while B<unicmp> is not.
-Unlike the cmp operator which sorts according to codepoint, B<unicmp> and
-B<coll> sort according to how most users would expect.
-
-    use experimental :collation;
-    say 'a' unicmp 'Z'; # Less
-    say 'a' cmp 'Z'; # More
-
-B<coll> and the B<collate> method are both configurable by setting the
-B<$*COLLATION> variable.
-
-=head2 collate (method)
-
-You can use the collate method similar to how one would use the B<sort> method.
-
-    use experimental :collation;
-    say ('a', 'Z').sort; # (Z a)
-    say ('a', 'Z').collate; # (a Z)
-    say <ä a o ö>.collate; # (a ä o ö)
-    my %hash = 'aa' => 'value', 'Za' => 'second';
-    say %hash.collate; # (aa => value Za => second);
-
-=head2 Collation Levels
-
-There are four collation levels which are all configurable.
-
-While the Primary, Secondary and Tertiary mean different things for different
-scripts, for the Latin script used in English they mostly correspond with
-Primary being Alphabetic, Secondary being Diacritics and Tertiary being Case.
-
-In the below example you can see how when we disable tertiary collation which in
+In the example below you can see how when we disable tertiary collation which in
 Latin script generally is for case, and also disable quaternary which breaks
 any ties by checking the codepoint values of the strings, we get B<Same> back
 for B<A> and B<a>:
 
     use experimental :collation;
     $*COLLATION.set(:quaternary(False), :tertiary(False));
-    say 'a' coll 'A'; # Same
+    say ('a','A').collate == ('A','a').collate; # OUTPUT: «True␤»
 
-B<Note the collation features, especially the $*COLLATION API could change
-at any time>
+The $*COLLATION API could change at any time, so use it with caution.
 
 =end pod