Hi Folks,

While the tone of this conversation is a little unpleasant
I think there are good points about the readability of the
reference documentation.

For instance, I understand that List inherits from
"Cool", but listing trigonometric functions on this
page

  https://docs.raku.org/type/List

really hurts readability; nobody is going to call "cotan"
on a list.  In my opinion, this section should maybe have
a link to the "Cool" page at most, perhaps in a footnote.

Also this exact same list appears on every page that inherits
from Cool

  https://docs.raku.org/type/Range
  https://docs.raku.org/type/Map
  https://docs.raku.org/type/Seq
  https://docs.raku.org/type/Match
  etc

I get that the list of methods is comprehensive, but I would argue that
seeing things like Match.sqrt, Seq.log10 and Range.lc are distracting and
these pages could benefit a less pedantic presentation

Brian

Reply via email to