Re: Notes Status, 23867 total

On Sat, Jun 11, 2022, 10:49 PM Robert Woodall <[email protected]> wrote:

> Instead of spending so much time on these notes, is there a more
> actionable method such as Q/A like Stackoverflow? Or maybe an inline commit
> edit approval method to just improve the docs naturally instead of forcing
> non natural collaboration? I myself think the examples are awful and the
> comments probvide better ones. Could we encourage the policy we want with
> new functionality?
>
> It seems too hard to contribute I guess.



There's been discussion about nuking negative notes, but I think the
consensus was "not right now" or at least waiting until a time in the
future. The general idea behind the comments section is that the higher
quality comments are rolled into the manual page, and the comments are
deleted. Ideally, the comments section stays relatively clean. However, as
you can tell, it's easy for pages to have a seemingly overwhelming number
of comments to go through, especially since there are numerous manual pages.

If you notice an example on a page is worse than an example contained in a
comment, I encourage you to submit a PR and either including the better
example on the page, or replacing the worse example altogether.