Writing good documentation is difficult. From those who say
"the source code explains everything", I think 80% are too
lazy to write documentation in the first place.
Having said that, I found consistently that when a project
has working examples, ideally documented a bit, aka explained,
they tend to work much better than those projects that have
no examples. Working examples often also help get into a project
quickly and check out how it works. It helps to learn too.
READMEs are not useless, of course, but the quality varies a lot.
I also know of folks who use AI slop spam to improve it, but while
it may improve a little bit, it generates a lot of horribly to read
text that makes no sense. I am noticing this with the ruby core dev
team - they (almost) all suddenly have perfect language skills but it
is more like an advanced babelfish translator. What they piece together
here makes no sense. Claude in particular is now famous for this slop
content. And I don't understand what it is used: real people read any
of this AI slop? Because I just skip it or filter it away these days.
>From those who say "the source code explains everything"
Because theoretically you should be able to describe not only your entire application logic, but upper and lower bounds of inputs as well. Good code would describe this inherently.
Documentation is only useful when a) the application is not source available, so you have no choice, b) you want to save a human developer time for them to understand your code, or c) you want to use documentation as a cache hit for agent use (less token spend)
I can not comment on the vibe coded issue or not, but the name
Alprose is not really a surprising name at all.
Alps are "Die Alpen" in german, and rose is rose too. So, a rose
or a flower in a mountaineous area. It kind of fits to Switzerland.
Renaming operations are often strange: for instance, the name
Raider before it then became Twix. I always found the renaming
part peculiar; guess Twix is easier to market than Raider but
both names are strange to begin with.
I could also swear that Raider tasted better than Twix, but this
could be to my aging cells no longer being as performant as they
once were. Or they changed the recipe to the worse.
Having said that, I guess that website was AI slop generated, so no wonder it has low quality. I try to avoid AI in general, in particular the low quality slops; sadly youtube is being infected with it, I can no longer watch shorts - so many are just AI spam nowadays.
I didn't mean the name is strange, it's just a strange example to show up first as it's a very niche company you won't easily find to buy anywhere in Europe.
My parents also swear raider was the better product. Not sure if I ever tried one.
This is the outcome when you have lobbyists control a government. In this
regard the Trump-administration is by far the most hostile to people.
You still have to wonder why Trump has a 30% support base; that should be
at 0% already but some people can not think on their own (excluding the 5%
who benefit personally from the Trump clique).
In principle that statement is not incorrect in that
lobbying means that one is able to represent a view.
However had, if money flows, then this skews all bias
towards that money addiction flow, at the expense of
everyone else. And most lobbying is due to money,
that's also a fact.
Having said that, I found consistently that when a project has working examples, ideally documented a bit, aka explained, they tend to work much better than those projects that have no examples. Working examples often also help get into a project quickly and check out how it works. It helps to learn too.
READMEs are not useless, of course, but the quality varies a lot. I also know of folks who use AI slop spam to improve it, but while it may improve a little bit, it generates a lot of horribly to read text that makes no sense. I am noticing this with the ruby core dev team - they (almost) all suddenly have perfect language skills but it is more like an advanced babelfish translator. What they piece together here makes no sense. Claude in particular is now famous for this slop content. And I don't understand what it is used: real people read any of this AI slop? Because I just skip it or filter it away these days.