Missing web documentation for some Role (and other) related Metamodel classes/roles

[BenGoldberg1]

If I run role R { }; R.HOW.say the output is Perl6::Metamodel::ParametricRoleGroupHOW.new␤ ... this does not seem to be documented...

On the same note, the type graph for Any on https://docs.perl6.org/type/Any.html has some links to Role related things which are 404 Page Not Found:

• https://docs.perl6.org/type/Metamodel::RolePunning
• https://docs.perl6.org/type/Metamodel::ConcreteRoleHOW
• https://docs.perl6.org/type/Metamodel::CurriedRoleHOW
• https://docs.perl6.org/type/Metamodel::ParametricRoleGroupHOW
• https://docs.perl6.org/type/Metamodel::ParametricRoleHOW
• https://docs.perl6.org/type/Metamodel::PackageHOW

After figuring out why these pages weren't generated, please add automatic test so that, after all the web pages are generated, there are no links to 404 pages.

Thanks!

[coke]

(this ticket can be for docs, we can open a separate ticket for automatic testing)

[JJ]

Ref #1846

[JJ]

There are several problems with this issue:

• Those classes are defined in the Perl6 namespace, thus not really there. For instance, Perl6::Metamodel::RolePunning. This should change, at least, the definition in the top of the page.
• There are many other classes that are not listed in type-graph.txt (or already in the documentation)
• They are implementation dependent, as @zoffixznet said.
• They can't actually be used. So what's the use of listing its methods, for instance? They can be accessed through the metamodel, but still.

So I don't really know what to do with them. It does not make a lot of sense to hide them, not a lot of sense to list them exhaustively. Anyway, errors must be fixed...