Comment by 0x696C6961

Comment by 0x696C6961 a day ago

8 replies

"No documentation" was never presented as an option. Documentation exists. By treating "insufficient docs" as "no docs", you're the one making the false equivalency.

dns_snek a day ago

> Documentation exists

Where does a beginner go to learn how to use the package manager these days? It looks like they still won't find any clues in the "Learn" section of Zig's website.

There's a promising page titled "Zig Build System" in there which references a "Package Management" section, but when you click on it, it doesn't exist!

  • 0x696C6961 a day ago

    So in your mind, one missing section means "no documentation"? This isn't the checkmate you think it is, you're just moving goalposts.

    But to answer your question, it exists in the comments of the auto-generated build.zig.zon file

    • dns_snek a day ago

      It's not just "one missing section", and we're not just talking about some fringe language feature but the build system which is probably the most complex, important, and under documented part of the language.

      The official answer to complaints about missing documentation has always been "ask in Discord". Pretending that this isn't the case is just disingenuous.

      > But to answer your question, it exists in the comments of the auto-generated build.zig.zon file

      The comments document the file format of build.zig.zon, they don't tell you anything about how to actually use a dependency in your build system.

      • kristoff_it a day ago

        I've added more explanatory comments in the new template that ships with 0.15.1, also you might be interested in this video https://www.youtube.com/watch?v=jy7w_7JZYyw

        • dns_snek 18 hours ago

          Thank you! I've learned how to use it well enough for own my needs by now but I think it would be really helpful to beginners if links to this video and any other useful resources you know about were added to the "Zig Build System" page on your website.

      • [removed] a day ago
        [deleted]
    • CRConrad 11 hours ago

      > you're just moving goalposts.

      Pretty funny, coming from someone who went from "false dichotomy" to "the false equivalency".