4 ms·

Isn't it nice when good documentation is treated as more than an afterthought? This is good to see :)

• vipermoney 5y ago
  Judging by the massive amount of unfixed bug reports linked in this email, doesn't it seem like documentation has been an afterthought for them for a long time? Does anyone have a comparison for OpenBSD or NetBSD's documentation having outdated or incorrect info?
  • the_only_law 5y ago
    NetBSD documentation is just straight up missing sometimes. iirc a lot of kernel interfaces are both missing documentation and are different than other BSDs. You either need dig through the source or ask for help.
  • 1over137 5y ago
    Is that really such a massive number of bug reports, for a project as large as FreeBSD? I'm not convinced.
    • vipermoney 5y ago
      Perhaps it's not as large as you think, relatively speaking. If we take a look at bugs.freebsd.org, it seems that many bug reports are opened and left to rot for years. The documentation section of the tracker is no exception. https://bugs.freebsd.org/bugzilla/page.cgi?id=showreport.html&type=total_open_bugs_over_time https://bugs.freebsd.org/bugzilla/page.cgi?id=showreport.htm... Seems to be getting worse with time too.
      • 1over137 5y ago
        >many bug reports are opened and left to rot for years Yup. This is common for many project, like llvm: https://github.com/llvm/llvm-project/issues https://github.com/llvm/llvm-project/issues