REST API docs

[Benjamin Herrenschmidt]

On Thu, 2017-08-03 at 01:08 -0500, Patrick Williams wrote:
> 
> Do you have any guidelines to help me out here on what is significant
> enough to write a better "announcement" of and how detailed it needs to
> be?  I'm obviously failing and I don't have any clear advise other than
> "this is a particular instance when we wanted to know more details."
> 
> What Stewart does for skiboot is great and I respect the effort he puts
> into these:
> 
>    * https://lists.ozlabs.org/pipermail/skiboot/2017-July/008067.html
> 
> What he does here, to the best of my reading, is to write a paragraph
> for nearly each commit sequence he merges.  Again, this is great.  I do
> not have the availability to do this.  If someone would like to help
> out, I'm all for it.

What might work better is to maintain some kind of wiki with the
highlights, or at least the stuff that can have a significant usability
impact, so people get used to go there.

For example, everybody's hitting obcmutil poweroff vs. chassisoff,
so that would be a good candidate to have up the top there.

> I will warn that we have on the order of 150 commits per 2 week sprint
> spread across about two dozen repositories.  This would be a pretty
> significant undertaking for anyone.

Ben.