viraptor a day ago

In serious codebases docs are not an afterthought. There's lots of places where you're expected to add both a new interface and docs together.

Reply View 4 replies
  • rjh29 a day ago

    It's pre-1.0 beta. Nothing has been 'released' yet .

    Reply View 3 replies
    • viraptor a day ago

      That's ok. "It's an unstable, experimental, early version." is a valid explanation. GP put the lack of docs and the new interface together, which... isn't an excuse.

      Reply View 2 replies
      • geon a day ago

        That Zig is pre 1.0 is a given. Not sure how you could take my statement as ”even post 1.0 releases don’t need docs.”

        Reply View 1 reply
        • viraptor 19 hours ago

          > Not sure how you could take my statement as ...

          I didn't.

          Reply View 0 replies
speed_spread a day ago

You absolutely should expect documentation this early. The chances of quality documentation being added as an afterthought are not good. If proper documentation isn't part of the original goals after that time, things aren't looking well. Nobody is going to come and just write docs for months.

Reply View 1 reply
  • geon a day ago

    Zig is open source, so the docs are pretty much a wiki. You can spend 5 minutes.

    Reply View 0 replies
wordofx a day ago

So zig isn’t a serious language. It’s just some trash apis thrown together.

Reply View 1 reply
  • maxbond a day ago

    It's a serious language, it's just not a stable language yet.

    Reply View 0 replies