Improve API docs

[myrho]

Users find it hard to find the API docs and to find out what the endpoints do and what the response fields mean in detail.

For instance, what the first/last_tx on the address neighbor endpoint result type mean: Is it just the first/last_tx between the neighboring addresses or is it the first/last_tx the neighbor address has ever got? The latter is the case, but it is not obvious.