SORU
17 NİSAN 2009, Cuma


Arabirimi, uygulama ya da her iki yorum?

Hepsi (rahatsız olabilir!) biz hayal ediyorum bizim arabirimleri yorum. örneğin

/// <summary>
/// Foo Interface
/// </summary>
public interface Foo
{
    /// <summary>
    /// Will 'bar'
    /// </summary>
    /// <param name="wibble">Wibble factor</param>
    void Bar(string wibble);
}

Ayrıca uygulama da, örneğin bir kütüphanenin bir parçası olarak müşterilere sunulan olabilir) bir yorum yapar mısın? Nasıl senkronize iki tutmak geçiniyorsunuz? Yoksa sadece bir 'belgeleme' yorum? arabirimi Görmek ekleyin

Teşekkürler

CEVAP
17 NİSAN 2009, Cuma


Genel bir kural olarak, kodu ile (Kendini Tekrar Etme) Aynı KURU prensibi kullanın:

  • arabirim, arayüz belge
  • uygulama, Uygulama Detayları belge

Java özel: uygulama belgeleme, kullanma {@inheritDoc} "" javadocs arabirimi. eklemek etiketi

Daha fazla bilgi için:

Bunu Paylaş:
  • Google+
  • E-Posta
Etiketler:

YORUMLAR

SPONSOR VİDEO

Rastgele Yazarlar

  • Emotional Trancer

    Emotional Tr

    4 Mart 2010
  • lilstevie89

    lilstevie89

    25 Mart 2011
  • Within Temptation

    Within Tempt

    18 EYLÜL 2006