Improve, in general, documentation about TWEAK

[tbrowder]

also explain its advantages over other methods of object contruction

[JJ]

Where? For instance, here: https://docs.perl6.org/language/objects ? Right now there is this example:

class RectangleWithCachedArea {
    has ($.x1, $.x2, $.y1, $.y2);
    has $.area;
    submethod TWEAK() {
        $!area = abs( ($!x2 - $!x1) * ( $!y2 - $!y1) );
    }
}
 
say RectangleWithCachedArea.new( x2 => 5, x1 => 1, y2 => 1, y1 => 0).area;

It's also mentioned several times. I don't think it really deals with its advantages...

[tbrowder]

I didn't see the example because it is far below the search reference point for TWEAK. I added a note there that there is an example later in the text. Closed with 1b723a2.

[JJ]

Reopen with slightly changed title. Also try and rescue the good parts of #3502 (possibly most)

[tbrowder]

This is still troubling me for the paucity of real-world examples. I asked for help for a practical class construction on #raku a couple of days ago and got some info that is helpful but I don't find it in the docs. I'm looking for the discussion reference now and will add it here.

Ah, the link: the discussion starts here

Now that I review the convo again, I think my immediate need may be solved by my own new method!

[JJ]

Please do.

[tbrowder]

Wrong, TWEAK enables me to do exactly what I need for my use case.

[tbrowder]

Submethod TWEAK is missing on the Type system page (typesystem.pod6)

[arkiuat]

During the last year I also have gone looking for more information about how and when to use TWEAK and thought what I found was awfully sparse. It seemed as if BUILD was documented pretty thoroughly before TWEAK was implemented, and even though TWEAK is now preferred to BUILD in many (most?) cases, it's documented much more sparsely than BUILD is.

Not saying that this is actually the case, just the impression I got from studying the recent docs.