Witam,
Jak stworzyć w C# dokumentację, coś podobnego jak w javie jest javadoc. Na razie znalazłem tylko generowanie dokumentacji do postaci XML, co nie wydaję mi zbyt czytelne. W wymaganiach projektu na zaliczenie jest dostarczenie dokumentacji, tylko nie za bardzo wiem co opisać. Może jest jakiś dodatek do VS który wygeneruję taką dokumentację jak jest na MSDN?
Weźmy na przykład taką prostą klasę i nad czym tu się rozpisywać? Mam jeszcze parę takich klas i jedną do komunikacji z bazą danych (w tej już może się coś znajdzie do opisania).
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
namespace HCompany
{
public class Person
{
protected string id;
protected string name;
protected string lastName;
protected string email;
protected string cellPhone;
/// <summary>
///
/// </summary>
/// <param name="id"></param>
/// <param name="name"></param>
/// <param name="lastName"></param>
/// <param name="email"></param>
/// <param name="cellPhone"></param>
public Person(string id, string name, string lastName, string email, string cellPhone)
{
this.id = id;
this.name = name;
this.lastName = lastName;
this.email = email;
this.cellPhone = cellPhone;
}
public string Id
{
get { return id; }
set { id = value; }
}
/// <summary>
/// Name property. </summary>
/// <value>
/// A value tag is used to describe the property value.</value>
public string Name
{
get {return name;}
set { name = value;}
}
public string LastName
{
get { return lastName; }
set { lastName = value; }
}
public string Email
{
get { return email; }
set { email = value; }
}
public string CellPhone
{
get { return cellPhone; }
set { cellPhone = value; }
}
}
}