REST API docs

[Benjamin Herrenschmidt]

On Wed, 2017-08-02 at 08:01 -0500, Patrick Williams wrote:
> he documentation should be updated.  As I said, I've been
> pointing out new interfaces being available (with an implementation) in
> tag messages.  There are on the order of 500 commits going in every
> month.  It really isn't possible for me to know which ones someone on
> the mailing list might be interested in.
> 
> As we've said since the beginning of the 2.0 stream, all work is being
> tracked on github.  You can see every feature being worked on and see
> exactly when it closes due to the code being merged.  I get that Linux
> has amazing announcements and wikis for each release, like
> kernelnewbies, but those aren't done by Linus himself and I certainly
> don't have the bandwidth do it.

Nobody has the bandwidth.

What you are saying is "if you use the project, you have to read and
track every commit message for breadcrumbs of documentation because we
aren't goin to keep the docs up to date".

This is just wrong and impossible for your users.

Ben.