Hacker News Reader

Comment by nusaru | Hacker News Reader

I like the idea for this project, but not a huge fan of the AI-written docs.

I don't think it's just the docs that are LLM written.

I try not to be negative, but this software seems bizarre. It's a Lua meta manager written in Zig, that calls itself cross platform (Linux / MacOS only), and depends on external gnu build tools, not even the native Zig portable retargeting llvm.

LLMs are usually too busy agreeing to push back on the ideas & details like this.

More than one platform, different arch/ABI qualify as cross-platform, it is not stated as omni-platform... Zig CC (LLVM backed) is widely used across for materializing first-class C modules. It aims to leverage the Lua ecosystem then it is expected to rely on GNU tools for building legacy, already upstream and stablished LuaRocks packages, i.e. makefiles, or GCC dependent recipes. That is a pragmatic compatibility choice to use the existing Lua ecosystem out-of-the-box, while it is encouraged the use of moonstone native hermetic recipes (which rely on zig cc).

Contributions are greatly appreciated. Feel free to contact this email maximoverzini@gmail.com if you'd like to collaborate!

To give some context:

Moonstone is currently under heavy, messy(getting better with time), active development. As I build various Lua + Zig projects with it, API contracts, CLI routes + flags, and configurations are constantly shifting. Using AI co-authoring has been a bit of a survival mechanism to ensure the documentation doesn't fall completely out of sync with the codebase. That said, AI authored docs can definitely feel dry to the eye, and/or verbose. If you or anyone else would like to help prune, rewrite, or polish the documentation to make it read more naturally, I would be incredibly grateful for the help!

I suspect the AI docs will make it hard to find humans who want to contribute writing. Humans will want to contribute if they see that you value writing highly.

This just sounds like an excuse to complain about things without wanting to actually do anything about them.

I just don't get why docs are bashed for being AI written, while software gets praised by being AI written.

In every, single, new HN post.

I don't get how every post you make gets exactly 8 upvotes immediately.

In every, single, new comment.

(I don't really care, I just noticed it now. I honestly enjoy many of your comments.)

Lucky vibes.

Click. Couldn't resist your lucky charm, pjmlp (9).

I don't get, how you found that out, as HN does not show post upvote?

Checking his profile multiple times for the total score and compare when a post was made?

Browser extension: Hacker News Enhancement Suite

I just installed that extension and it doesn't show the actual number of votes.

Weird, I see yellowapple (1).

Huh. Are we using different versions, then? I'm using the one on addons.mozilla.org.

EDIT: I'm now seeing some numbers by usernames; I think that's just how many times you've upvoted that user's posts/comments, not the total upvotes on that particular comment.

So likely a missunderstanding alltogether.

(The person above was upvoted 8 times by the one below)

i need to read the docs. i don’t need to read the code.

Reply on news.ycombinator.com