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@linux.intel.com 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@linux.intel.com 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.