Re: [PATCH] lib: add basic KUnit test for lib/math
From: Andy Shevchenko
Date: Fri Oct 23 2020 - 05:01:29 EST
On Thu, Oct 22, 2020 at 02:21:40PM -0700, Brendan Higgins wrote:
> On Thu, Oct 22, 2020 at 12:04 PM Andy Shevchenko
> <andriy.shevchenko@xxxxxxxxxxxxxxx> wrote:
> > On Thu, Oct 22, 2020 at 11:53:50AM -0700, Brendan Higgins wrote:
> > > On Thu, Oct 22, 2020 at 8:06 AM Andy Shevchenko
> > > <andriy.shevchenko@xxxxxxxxxxxxxxx> wrote:
...
> > Why do we have docs in the first place?
> > For test cases I think it's a crucial part, because tests many time are written
> > by newbies, who would like to understand all under-the-hood stuff. You imply
>
> Good point. Yeah, we don't really have any documentation that explains
> the internals at all. I agree: we need to fix that.
>
> > that they need to drop themselves into the code directly. It's very harsh to
> > begin with Linux kernel development, really.
>
> No, I was not trying to imply that everyone should just jump in the
> code and ignore the docs. I was just trying to point out that some
> people - myself included - rather see code than docs. Clearly some
> people prefer docs over code as well. Thus, I was trying to argue that
> both are appropriate.
>
> Nevertheless, based on the other comments you sent, I don't think
> that's what we are talking about: sounds like you just want us to
> improve the docs first to make sure we do it. That's fine with me.
Right. What confused me is that test cases for math were pushed as a good
example how to create a test case, but at the same time docs left untouched.
--
With Best Regards,
Andy Shevchenko