Hacker News new | ask | show | jobs
by mjw1007 3191 days ago
It's very strange that adding/updating documentation isn't treated as a basic requirement for a patch that adds to or modifies Linux's public interfaces.
3 comments

For the BSDs, incorrect or missing man pages are considered a serious bug.
Man pages aren't even in the kernel tree.
From Documentation/process/submit-checklist.rst:

  19) All new userspace interfaces are documented in ``Documentation/ABI/``.
      See ``Documentation/ABI/README`` for more information.
      Patches that change userspace interfaces should be CCed to
      linux-api@vger.kernel.org.