4 ms·

i find that zig is too oriented at doling out directives for what not to do instead of just collecting and teaching variants of how and what to do. the lack of

by ulbu 1y ago

i find that zig is too oriented at doling out directives for what not to do instead of just collecting and teaching variants of how and what to do. the lack of documentation on this interface is a sore case in point.

geon 1y ago
You can’t expect documentation this early. The new interface was just released.
- viraptor 1y 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.
  - rjh29 1y ago
    It's pre-1.0 beta. Nothing has been 'released' yet .
    - viraptor 1y 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.
      - geon 1y 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.”
        viraptor 1y ago
        > Not sure how you could take my statement as ... I didn't.
- wordofx 1y ago
  So zig isn’t a serious language. It’s just some trash apis thrown together.
  - maxbond 1y ago
    It's a serious language, it's just not a stable language yet.
- 7bit 1y ago
  [flagged]
- speed_spread 1y 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.
  - geon 1y ago
    Zig is open source, so the docs are pretty much a wiki. You can spend 5 minutes.