> The default gist method in Mu re-dispatches to the perl method for defined invocants, and returns the type name in parenthesis for type object invocants. Many built-in classes override the case of instances to something more specific that may truncate output.
And I have no idea how anyone that isn't already fluent in Perl 6 is expected to read that.
EDIT: My point is mostly that it just seems... weird. Like, I get the animating idea of Haskell, even if I don't understand all of the concepts. Perl 6 just seems... alien. It's incredibly funky.
If you want to start from the bottom out, there's the ever improving language docs: https://docs.perl6.org/language.html
Quite a few languages have that kind of feature though I believe. PHP has print_r and var_dump, Perl 5 had Data::Dumper, Python has tools too which I forget the name of.
I like how Perl 6 has baked it into the language though rather than making it a part of the standard library.
But IMO, like others have said, it is not really that difficult to figure out what it means (if you know some OOP) (although some of the rarely-used words (e.g. "invocants") get in the way a bit.
Basically when I read your comment, I figured out that the default gist method (even the word "gist" is a clue) was something like a default-valued method (to print the representation of any object) that can be overridden on a case-by-case basis by any other object - something like Python's __str__() and __repr__ special methods, like others have said.
However, having read some of it, I'll have to agree with you that the Perl6 docs can do with some improvement (check out Phasers in the Perl 6 manual for an example of what I mean) - whereas, in contrast, the Perl 5 docs are considered by some (me too) to be good-to-excellent. But then Perl6 has been evolving for less time (yes, I know about the long time for the 1st stable release).
This specific example seems similar to the __repr__ vs __str__ thing in Python, and not very alien at all.
More info about it:
m, a Unix shell utility to save cleaned-up man pages as text:
https://jugad2.blogspot.com/2017/03/m-unix-shell-utility-to-...
Other resources exist which are targeted at newcomers and explain things differently.