hello Polgár,
On Sat, Oct 12, 2024 at 07:15:27AM +0000, Polgár Márton wrote:
> it's a bit ironic that I still get these messages and care enough to
> read and respond - anyway.
thanks for doing that!
> This "the website is terrible" is still a trigger point.
I didn't mean to be rude or something. For personnal reasons, I stepped
back from any open source activities for many years, wasn't tunned even
tunned on my projects of interest. So I had no idea the documentation
was a touchy thing. In general, I think the Raku community at large
diserve much more attention and gratitude as the work is really amazing.
I present raku as the "only modern scripting langage", the one which
rises the barrier so high there is no true competitor. When I came back
to it, the very good surpise was that the performance issues I
mentionned years ago seems to be gone so to me there is no more real
argument against raku adoption.
My only complain about the documentation is something very personnal: I
hate useless parentheses and there are so many of them in the raku doc.
If I have the bless of the community, it would be my first contribution
since very long time.
So:
* I gave this talk to very open minded people so we can agree to use
raku at work as a python replement when it's possible (remove the
pandas stuff). they know
* how hard achieving something that big could be
* how projects can go wrong for nothing related to technical stuff
* they are able to contribute instead of critize
* "terrible" was just a subjective user perspective from someone
who is well known to hate the web at large anyway.
So if you are/were part of the doc team:
* thank you very much for everything you already did
* I beg your pardon if I hurted you
When I told the site was "terrible", I demonstrate my prefered way to
read the doc so far which is based on the usage of those 2 functions
from a vim buffer:
n () grep -Hn "$@"
rd () n "$@" ~/src/vendor/raku/doc/*
and I have to admit that the audience wasn't convinced at all.
> plenty of us know the untenable situation that led to a more or less
> working documentation workflow and the new website stack,
I had no clue about it! I was so far from all of that you really should
consider me as a newcommer.
> From what I can tell, the doc website is among the few things you can
> easily get into and make things happen on your own. Anyway, how is it
> terrible? Is it the content, the design, the site structure, the
> infamous search bar that had to be completely reworked, or what?
If you are interested about feedbacks, I'll provide it if I use this
site again but AFAIR, my feeling is based on the fact that:
* due to my terrible vision, I zoom a lot.
* doing this, I loose direct acccess to features and I am anoyed by lot
of spaces and margins that are probably really nice when you use high
definition large screens. Hardcore web designers will probably say
"we can improve the responsiveness of the site" and it would be great
but it is useless in my case as I choose techologies that:
* can be used offline
* give the user the power of chosing the way it
render/index/bookmark/quote things.
the web is a complete desater from that perspective. that's why I
still use mailing lists from my mutt and still think there is no
decent competitor.
* news about the site pops up when you open it and I'm really unhappy
with unsolicited content. I really would like a "news" entry (even a
an RSS feed) from the site
> Apparently there is a downloadable epub version as well (work in
> progress), I suspect many people would want something like that...
I'll give a try on it. there are many zeal users so providing a zeal
version can help to promote raku too (as it will appear in the list of
docsets)
> By the way, if you want an offline terminal tool, you should check out
> the rakudoc script. I think something additional might need to be
> downloaded for the source documents but I'm sure somebody can help set
> things up.
thank you for pointing it out. I'll give a try too.
regards.
--
Marc Chantreux
Pôle CESAR (Calcul et services avancés à la recherche)
Université de Strasbourg
14 rue René Descartes,
BP 80010, 67084 STRASBOURG CEDEX
03.68.85.60.79
