Gostaria de receber alguns esclarecimentos sobre as páginas de ajuda geradas pela web.

Tanto quanto eu poderia entender, se eu retornar um tipo, ele irá gerar automaticamente a página de ajuda para essa ação com um exemplo. Mas, se eu usar HttpResponseMessage, é compreensível que ele não consiga adivinhar qual será a resposta e só possa fazer suposições sobre os parâmetros da solicitação.

O motivo pelo qual eu estava usando o HttpResponseMessage foi porque foi recomendado indicar o código de status que você deseja retornar quando ele pode ser diferente de 200.

assimqual é a abordagem de melhor prática ser capaz de retornar os códigos de status desejados, mas ainda tem as páginas de ajuda trabalhando com os tipos que você está retornando?