Some initial documentation for type Stash

lib/Type/Stash.pod

@@ -0,0 +1,38 @@
+=begin pod
+
+=TITLE class Stash
+
+=SUBTITLE Tables for "our"-scoped symbols
+
+    class Stash is Hash { }
+
+A C<Stash> is a hash that is used for symbol tables at the package scoped in
+Perl 6.
+
+To get a Stash, you can all the C<.WHO> pseudo method on a package (because it
+answers the question I<who lives here?>), or if you write the package name as
+a literal, append two colons:
+
+    class Boring {
+        class Nested { };
+        our sub package_sub { }
+        my sub lexical { };
+        method a_method() { }
+    }
+
+    say Boring::.^name;             # Stash
+    say Boring.WHO === Boring::;    # True
+
+Since it inherits from L<Hash|/type/Hash>, you can use all the usual hash
+functionality:
+
+    say Boring::.keys.sort;         # &package_sub Nested
+    say Boring::<Nested>;           # (Nested)
+
+As the example above shows, lexicals and methods are not included in a Stash,
+since they do not live in the package table. (Methods have a separate method
+table, and are accessible through method calls or C<.can> and C<.^methods>,
+and lexicals live in a separate lexical pad, which is only from inside the
+scope).
+
+=end pod