Add endpoint documentation

[chiiph]

No description provided.

[zwass]

Nice summary! A few copy edits from me.

Would be great to make sure that someone who's been working with this more recently gets eyes on this before merging.

[roperzh]

❤️ very very nice, and super useful.

It would be amazing if we also mention some of the logic we have in place to modify the response (which can't be done directly at the handler):

fleet/server/service/transport.go

Lines 36 to 46 in be77594

	if render, ok := response.(renderHijacker); ok {
	render.hijackRender(ctx, w)
	return nil
	}
	if e, ok := response.(statuser); ok {
	w.WriteHeader(e.Status())
	if e.Status() == http.StatusNoContent {
	return nil
	}
	}

[roperzh]

I think it would benefit the reader if we're more precise here, we have an interface fleet.Service and an struct service.Service that implements the interface.

[mna]

LGTM! Left a couple comments about possible missing pieces of info.

[Desmi-Dizney]

Editor pass completed on:

• Editor pass - Add endpoint documentation #6414