Agradecería alguna aclaración sobre las páginas de ayuda generadas automáticamente por la API web.

Por lo que pude entender, si devuelvo un Tipo, generará automáticamente la página de ayuda para esa acción con un ejemplo. Pero si uso HttpResponseMessage, es comprensible que no pueda adivinar cuál será la respuesta y solo puede hacer suposiciones sobre los parámetros de solicitud.

La razón por la que estaba usando el HttpResponseMessage fue porque se recomendó indicar el código de estado que desea devolver cuando puede ser diferente a 200.

Asi que¿Cuál es el enfoque de mejores prácticas? para poder devolver sus códigos de estado deseados, pero aún así, ¿tiene las páginas de ayuda que resuelven los tipos que está devolviendo?