core rest api docs out of date

[Kyle Nitzsche]

The following call:
GET /v2/system-info

Returns output [1] that is quite different [2] than what I see on a pi3 with:
snap 2.28.5
snapd 2.29.3
series 16
kernel 4.4.0-1030-raspi2

[1] Docs (https://docs.ubuntu.com/core/en/reference/rest) show this:
{
    "series": "16",
    "version": "2.0.17",
    "os-release": {
        "id": "ubuntu",
        "version-id": "17.04",
    },
    "on-classic": true,
    "managed": false
}

[2] system returns this:
{
    "type": "sync",
    "status-code": 200,
    "status": "OK",
    "result": {
        "confinement": "strict",
        "kernel-version": "4.4.0-1030-raspi2",
        "locations": {
            "snap-bin-dir": "/snap/bin",
            "snap-mount-dir": "/snap"
        },
        "managed": true,
        "on-classic": false,
        "os-release": {
            "id": "ubuntu-core",
            "version-id": "16"
        },
        "refresh": {
            "schedule": "00:00-04:59/5:00-10:59/11:00-16:59/17:00-23:59",
            "last": "2017-12-05T15:43:00Z",
            "next": "2017-12-05T17:41:00Z"
        },
        "series": "16",
        "version": "2.29.3"
    }
}

[John Lenton (chipaca)]

Agreed. However, note the docs talk exclusively about what's under "result", not the whole response -- things outside of "result" are documented elsewhere. There's a bunch of missing things in the doc, but it's not a completely different beast.

[Kyle Nitzsche (knitzsche)]

I was looking for documentation of "refresh" part and did not find it. Nor did I find a link to where the full set of docs is. So yes, this feels improvable.