Jestem zajęty tworzeniem Web API (wewnątrz aplikacji mvc4 asp). Korzystam z biblioteki sugerowanej w witrynie asp.net do generowania dokumentacji (http://www.asp.net/web-api/overview/creating-web-apis/creating-api-help-pages).

Moim problemem jest to, że jeśli mój parametr jest modelem, to nie mogę określić, jakie właściwości zawiera model na wygenerowanych stronach pomocy.

Oto przykład:

MODEL:

public class TestModel
{
    property String FirstName {get;set;}
    property String Surname {get; set;}
    property Boolean Active {get;set;} 
}

AKCJA:

/// <summary>
/// This is a test action
/// </summary>
/// <param name="model">this is the model</param> <-- this works
/// <param name="FirstName">This is the first name </param>  <-- doesn't work
/// <param name ="model.Surname">This is the surname</param> <-- doesn't work
public HttpResponseMessage Post(my.namespace.models.TestModel model)
{
  ...
}

Generowany jest tylko parametr modelu.

Przyjrzałem się dokumentowi XML, który jest generowany dla dokumentacji i dodaje inne parametry.

<member name="my.namespace.api.Post(my.namespace.models.TestModel)">
     <summary>
         this is a test action
     </summary>
     <param name="model>this is the model</param>
     <param name="FirstName">This is the first name </param>
     <param name="model.Surname">This is the surname</param>
</member>

Ale na stronach pomocy generuje tylko model parametrów.

Sprowadziłem go do metody, w której pobiera parametry z xml.

Collection<ApiDescription> apiDescriptions = config.Services.GetApiExplorer().ApiDescriptions;

Znajduje się w HelpPageConfigurationExtentions.cs, który jest generowany automatycznie.

Czy podchodzę do tego w niewłaściwy sposób? Czy ktoś wie o pracy?

Wszelkie sugestie lub rozwiązania zostaną docenione.