TehPers

It’s nice to see that business execs can be automated now though. Well, except the part where they openly bribe politicians I guess.

How are you accessing the website? Are you using a web server like miniserve or are you just opening the HTML files in a browser?

Beginning a path with / makes the path absolute for that origin. An origin is basically the URL’s scheme, domain, subdomains, and port (so https://www.example.com/foo/bar has the origin https://www.example.com/ - ignore the trailing slash, Lemmy keeps adding it…). If your URL begins with file:// then absolute paths will likely be absolute to your filesystem, not relative to your project’s directory.

If you can, try serving the directory with something like miniserve and see if it works. It’ll give you a better picture of what the website would look like if it were published for real. Otherwise, you can make the path relative to solve the problem without doing that.

To a repository? Might be good to put that in the post itself, honestly.

Is this just an ad? Or is there a repository somewhere that I can’t find?

made me realize do we still need documentation of how a software work when a AI can easily explain it?

I’ll respond for the sake of argument, but to put it bluntly: there are no stupid questions, just questions phrased stupidly.

Documentation comes in many formats. There’s prose documentation split into articles and chapters, there’s video documentation, inline documentation for code, tutorials, training, and so on. Most things are documented several ways. This is because people learn things differently from each other.

To remove documentation entirely and rely on only LLMs to document removes all of the ways that people might learn and narrows it down to only one form of documentation. Even if we ignore how fallible LLMs can be, having documentation in only a single format limits learning only to those who learn effectively through that format.

In other words, relying only on LLMs for documentation discards all of the millenia of teaching strategies learned throughout the course of human history and puts it in the hands of a stochastic magic box that is incapable of recreating those strategies.

cites the paper the algorithm came from

Having done this, I usually put a comment referencing which step of the algorithm I’m on along with whatever the “title” of that step is (the primary action from it, like “collect flex items into flex lines” from CSS Flexbox Level 1 step 9.3.5). Sometimes, the following line of code is that entire step and is self-explanatory, but I still feel like the comment explains why that line exists by referencing the algorithm directly.

I keep reading RoR as “Risk of Rain” and I have to admit that I’d be far more interested if their developers said something than if DHH did. DHH is pretty much just a wannabe Elon Musk, and nothing he says is worth the bytes of storage it takes to hold them.