On Sun, 9 Nov 2025, 04:27 ToddAndMargo via perl6-users, < [email protected]> wrote:
> On 11/8/25 11:59 AM, Richard Hainsworth wrote: > > Hi Todd, > > > > Long time since I responded to one of your questions. > Snip > > Hi Richard, > > I under stand why it is done that way. I just > do not like how it is done. > We all have our likes and dislikes. I know you document things with your keepers. But to be honest the ones you have published contain errors because they gloss over important topics. For example in your next sentence: > > "run" return its results in the OOP class "Proc". > There is an error! 'run' does NOT return it's results in the OOP class Proc!!! 'run' returns an object of type Proc. This is important because you can have many objects but there is still only one class. And the difference between type and class arises because (in Raku but not in many other languages) you can add roles to an object which means it will do more than just the methods of class Proc. And that is precisely what methods are documented by class and not by the routines which return objects of that class. The whole point of the secondary files is to aid in finding relevant information. But that is also the reason for the functionality in the search button. I think everyone agrees that search and the website could be improved. If you could find a way to suggest a systematic way of showing you how to get the information you need in a more intuitive way, please let me know. I'm writing a new version of the docs website. Take a look at https://new-raku.finanayst.org It looks a bit like the old one, but it works better on mobiles and tablets. There are bugs in it still. Currently I'm working on an upgrade to the RakuDoc Renderer, so the bugs will be there for a bit. However I really would like to have a better search function. > I wish the documentation would define what is > put into your Proc variable when "run" exits. > Not divide it up all over the place. > > Snip > > And, I should not have to find the source code > more readable and explanatory than the documents. > And that should tell you something! > > Thank you for the well written letter. > I appreciate it. > > -T > > >
