• Helix 🧬@feddit.de
    link
    fedilink
    English
    arrow-up
    10
    arrow-down
    2
    ·
    1 year ago

    NixOS options. They document themselves!

    Didn’t read past that as you clearly don’t understand what the differences between documentation, a tutorial and code comments are.

    • Atemu@lemmy.ml
      link
      fedilink
      English
      arrow-up
      3
      arrow-down
      2
      ·
      1 year ago

      Do read past that and you might understand why NixOS options are a type of documentation. They’re not “code comments”.

      • Helix 🧬@feddit.de
        link
        fedilink
        English
        arrow-up
        6
        arrow-down
        1
        ·
        1 year ago

        I have tried NixOS, the documentation in many options is subpar. Only the most interesting packages get good documentation. I’ll give NixOS a few more years until I try it again, but currently it’s rather a hobbyist and ‘tinkerer’ distribution. Which is fine, but I don’t want to learn domain specific stuff which is different from all of the rest of Linux.

        • Atemu@lemmy.ml
          link
          fedilink
          English
          arrow-up
          1
          ·
          1 year ago

          the documentation in many options is subpar

          Yes, this is an area we could achieve a great improvement without that much more work. It’s besides the point though as the point is that options are a type of documentation that can obviate a wiki.

          currently it’s rather a hobbyist and ‘tinkerer’ distribution

          I agree on the desktop side. Though I’d even consider most “normal” distros to land in this category too with only a few exceptions (Ubuntus, Fedora, that’s it?).

          On the server side, it’s extremely solid however. Configuring system services, networking and whatever are very mature at this point and it’s kinda where Linux most excels at.


          OT but why are you marked as a bot?