search

Raku / doc

🦋 Raku documentation
https://docs.raku.org/
Artistic License 2.0
291 stars 293 forks source link

Rewrite L<> section #4482

Closed coke closed 6 months ago

coke commented 6 months ago

Fixes #4481

tbrowder commented 6 months ago

On Sun, Jun 2, 2024 at 10:19 Will Coleda @.***> wrote:

@coke https://github.com/coke requested your review on: #4482 https://github.com/Raku/doc/pull/4482 Rewrite L<> section.

Will do. It looks better, but I just tried to make a comment on it on Github and murfled it. I'll go to a larger monitor and try again.

-Tom

coke commented 6 months ago

I am confused. You added "External links" but didn't put it on the external link section.

coke commented 6 months ago

I also don't understand your confusion: we introduce the concept in the paragraph before each sample now.

coke commented 6 months ago

I also hesitate to put in section headers for a single sentence, especially when things like "optional vertical bar" are included as part of the ongoing samples, and I don't think we should include them in each of those new sections. - to rephrase this: I'm thinking of it as a single cohesive section, not 3 individual ones.

tbrowder commented 6 months ago

I agree that the =head3s are too much. And I'll look at my file chunk again.

tbrowder commented 6 months ago

I'll try to respond later today.

tbrowder commented 6 months ago

Okay, I remove my objections. Your change is fine. Sorry for wasting your time.

coke commented 6 months ago

Okay, I remove my objections. Your change is fine. Sorry for wasting your time.

No waste - improving the docs is the goal; apologies from my end if I sounded rough!