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

  • Michael Neal

    Michael Neal

    2 Mayıs 2009
  • newport83

    newport83

    19 HAZİRAN 2006
  • NYLON Video

    NYLON Video

    11 Aralık 2006