Good catch! I think that one is worth a documentation issue. The perl6doc builder gathered information about all “new” methods it could find *without any context*, and put them into one file. For a method such as “new” not the best thing to do. I would argue that this page should be replaced by an ad-hoc page explaining the default way how the “new” method works.
In any case, Telemetry::Sampler should *not* be the entry on this page. > On 14 Sep 2018, at 12:30, Todd Chester <toddandma...@zoho.com> wrote: > > Hi All, > > What exactly is going on with .new? > > https://docs.perl6.org/routine/new > method new(Telemetry::Sampler: @instruments --> Telemetry::Sampler:D) > > The whole thing went over my head. It looks like > specifications for the developers, but I really can't > tell. And it looks like it might be really handy. > > What can I use it for? > > > Also, does "Telemetry::Sampler" mean what it does in Perl 5, > which is a routine called "Sampler" found in the module > called "Telemetry"? > > Many thanks, > -T