Re: [PATCH v2 2/2] docs-rst: userspace: update verbs API details

From: Mike Rapoport
Date: Wed Jan 16 2019 - 19:06:29 EST


Hi Jon,

On Tue, Jan 15, 2019 at 02:38:59PM -0700, Jonathan Corbet wrote:
> On Tue, 15 Jan 2019 22:37:01 +0200
>
> I'd rather see you put the new stuff under Documentation/driver-api, either
> in a standalone file or in a new subdirectory.
>
> Thanks for your patience with this! We really do want people to contribute
> more documentation, and I feel bad when it seems like I'm making it
> harder. My hope is that it will pay off in the long run; I think there are
> signs already that this is happening.

I believe its worth adding Documentation/doc-guide/where-to-put-stuff.rst
with at least basic guidelines for the desired organization of
Documentation/.

> Thanks,
>
> jon
>

--
Sincerely yours,
Mike.