Document the Positional/Associative .STORE method

Author: lizmat

doc/Language/subscripts.pod6

@@ -849,6 +849,22 @@ sense, so don't feel compelled to implement it. If you don't, users will
 get an appropriate error message when they try to bind to a positional slot
 of an object of this type.
 
+=head2 method STORE
+
+=comment When modifying this section, please also adapt the STORE
+         section in Associative accordingly as they are very similar.
+
+    method STORE (::?CLASS:D: values, :$initialize)
+
+This method should only be supplied if you want to support the:
+
+    my @a is Foo = 1,2,3;
+
+syntax for binding your implementation of the C<Positional> role.
+
+Should accept the values to (re-)initialize the object with.  The optional
+named parameter will contain a C<True> value when the method is called on
+the object for the first time.  Should return the invocant.
 
 =head2 Methods to implement for associative subscripting
 
@@ -959,6 +975,24 @@ sense, so don't feel compelled to implement it. If you don't, users will
 get an appropriate error message when they try to bind to an associative
 slot of an object of this type.
 
+=head3 method STORE
+
+=comment When modifying this section, please also adapt the STORE
+         section in Positional accordingly as they are very similar.
+
+    method STORE (::?CLASS:D: values, :$initialize)
+
+This method should only be supplied if you want to support the:
+
+    my %h is Foo = a => 42, b => 666;
+
+syntax for binding your implementation of the C<Associative> role.
+
+Should accept the values to (re-)initialize the object with, which either
+could consist of C<Pair>s, or separate key/value pairs.  The optional
+named parameter will contain a C<True> value when the method is called on
+the object for the first time.  Should return the invocant.
+
 =end pod
 
 # vim: expandtab softtabstop=4 shiftwidth=4 ft=perl6

doc/Type/Associative.pod6

@@ -70,16 +70,31 @@ you use the parametrized version of Associative.
 
 =head2 method AT-KEY
 
-    method AT-KEY(key) { }
+    method AT-KEY(key)
 
 Should return the value / container at the given key.
 
 =head2 method EXISTS-KEY
 
-    method EXISTS-KEY(key) { }
+    method EXISTS-KEY(key)
 
 Should return a C<Bool> indicating whether the given key actually has a value.  
 
+=head2 method STORE
+
+    method STORE(values, :$initialize)
+
+This method should only be supplied if you want to support the:
+
+    my %h is Foo = a => 42, b => 666;
+
+syntax for binding your implementation of the C<Associative> role.
+
+Should accept the values to (re-)initialize the object with, which either
+could consist of C<Pair>s, or separate key/value pairs.  The optional
+named parameter will contain a C<True> value when the method is called on
+the object for the first time.  Should return the invocant.
+
 =head1 See also
 
 See L<Methods to implement for positional subscripting|https://docs.perl6.org/language/subscripts#Methods_to_implement_for_associative_subscripting> for information about additional methods that can be implemented for the C<Associative> role.

doc/Type/Positional.pod6

@@ -23,23 +23,37 @@ to L<Mu>.
 
 =head2 method elems
 
-    method elems() { }
+    method elems()
 
 Should return the number of available elements in the instantiated object.
 
 =head2 method AT-POS
 
-    method AT-POS(position) { }
+    method AT-POS(position)
 
 Should return the value / container at the given position.
 
 =head2 method EXISTS-POS
 
-    method EXISTS-POS(position) { }
+    method EXISTS-POS(position)
 
 Should return a C<Bool> indicating whether the given position actually has a
 value.
 
+=head2 method STORE
+
+    method STORE(values, :$initialize)
+
+This method should only be supplied if you want to support the:
+
+    my @a is Foo = 1,2,3;
+
+syntax for binding your implementation of the C<Positional> role.
+
+Should accept the values to (re-)initialize the object with.  The optional
+named parameter will contain a C<True> value when the method is called on
+the object for the first time.  Should return the invocant.
+
 =head1 See also
 
 See L<Methods to implement for positional subscripting|https://docs.perl6.org/language/subscripts#Methods_to_implement_for_positional_subscripting> for information about additional methods that can be implemented for the C<Positional> role.