Add documentation to ClientService interface

[ffalor]

Problem statement

It would be nice to have the documentation for a endpoint to show up in the definition hover in tools like vscode.

Example:

type ClientService interface {
	DeprovisionSystemDefinition(params *DeprovisionSystemDefinitionParams, opts ...ClientOption) (*DeprovisionSystemDefinitionOK, error)
}

/*
DeprovisionSystemDefinition deprovisions a system definition that was previously provisioned on the target cid
*/
func (a *Client) DeprovisionSystemDefinition(params *DeprovisionSystemDefinitionParams, opts ...ClientOption) (*DeprovisionSystemDefinitionOK, error) {

Where if we were to add the comment to the fields we would get something like this:

type ClientService interface {
	/*
		DeprovisionSystemDefinition deprovisions a system definition that was previously provisioned on the target cid
	*/
	DeprovisionSystemDefinition(params *DeprovisionSystemDefinitionParams, opts ...ClientOption) (*DeprovisionSystemDefinitionOK, error)

Environment

swagger version: v0.30.5
go version: 1.21.1
OS: Win 10