─░├žeri─če ge├ž

Ultralytics A├ž─▒k Kaynak YOLO Depolar─▒na Katk─▒da Bulunma

Katk─▒da bulunmaya g├Âsterdi─činiz ilgi i├žin te┼čekk├╝r ederiz. Ultralytics A├ž─▒k kaynak YOLO Depolar─▒! Katk─▒lar─▒n─▒z projeyi geli┼čtirecek ve t├╝m toplulu─ča fayda sa─člayacakt─▒r. Bu belge, ba┼člaman─▒za yard─▒mc─▒ olacak y├Ânergeler ve en iyi uygulamalar sa─člar.

─░├žindekiler

  1. Davran─▒┼č Kurallar─▒
  2. Çekme İstekleri ile Katkıda Bulunma
  3. Hatalar─▒n Raporlanmas─▒
  4. Lisans
  5. Sonu├ž

Davran─▒┼č Kurallar─▒

Herkes i├žin s─▒cak ve kapsay─▒c─▒ bir ortam sa─člamak i├žin t├╝m kat─▒l─▒mc─▒lar Davran─▒┼č Kurallar─▒na uymal─▒d─▒r.

Çekme İstekleri ile Katkıda Bulunma

├çekme istekleri ┼čeklindeki katk─▒lar─▒ memnuniyetle kar┼č─▒l─▒yoruz. ─░nceleme s├╝recini kolayla┼čt─▒rmak i├žin l├╝tfen ┼ču y├Ânergeleri izleyin:

  1. Depoyu ├žatallay─▒n: Ultralytics YOLO deposunu GitHub hesab─▒n─▒za ├žatallay─▒n.

  2. Bir ┼čube olu┼čturun: ├çatallanm─▒┼č deponuzda de─či┼čiklikleriniz i├žin a├ž─▒klay─▒c─▒ bir adla yeni bir dal olu┼čturun.

  3. De─či┼čikliklerinizi yap─▒n: De─či┼čikliklerinizin projenin kodlama stiline uygun oldu─čundan ve yeni hatalar veya uyar─▒lar getirmedi─činden emin olun.

  4. De─či┼čikliklerinizi test edin: Beklendi─či gibi ├žal─▒┼čt─▒klar─▒ndan ve yeni sorunlara yol a├žmad─▒klar─▒ndan emin olmak i├žin de─či┼čikliklerinizi yerel olarak test edin.

  5. De─či┼čikliklerinizi i┼čleyin: De─či┼čikliklerinizi a├ž─▒klay─▒c─▒ bir commit mesaj─▒ ile commit edin. ─░lgili t├╝m sorun numaralar─▒n─▒ commit mesaj─▒n─▒za ekleyin.

  6. Bir ├žekme iste─či olu┼čturun: ├çatallanm─▒┼č deponuzdan ana Ultralytics YOLO deposuna bir ├žekme iste─či olu┼čturun. De─či┼čikliklerinizin ve projeyi nas─▒l geli┼čtirdiklerinin net bir a├ž─▒klamas─▒n─▒ sa─člay─▒n.

CLA ─░mzalama

├çekme iste─činizi kabul etmeden ├Ânce, bir Kat─▒l─▒mc─▒ Lisans S├Âzle┼čmesi (CLA) imzalaman─▒z gerekir. Bu yasal belge, katk─▒lar─▒n─▒z─▒n uygun ┼čekilde lisanslanmas─▒n─▒ ve projenin AGPL-3.0 lisans─▒ alt─▒nda da─č─▒t─▒lmaya devam etmesini sa─člar.

CLA'y─▒ imzalamak i├žin, PR'nizi g├Ânderdikten sonra CLA botu taraf─▒ndan sa─članan talimatlar─▒ izleyin ve PR'nize ┼č├Âyle bir yorum ekleyin:

I have read the CLA Document and I sign the CLA

Google-Style Docstrings

Yeni fonksiyonlar veya s─▒n─▒flar eklerken, di─čer geli┼čtiricilere a├ž─▒k ve ├Âzl├╝ belgeler sa─člamak i├žin Google tarz─▒ bir docstring ekleyin. Bu, katk─▒lar─▒n─▒z─▒n kolay anla┼č─▒lmas─▒n─▒ ve s├╝rd├╝r├╝lmesini sa─člamaya yard─▒mc─▒ olur.

├ľrnek Dok├╝man Dizeleri

Bu ├Ârnekte Google tarz─▒ bir docstring g├Âsterilmektedir. Hem girdi hem de ├ž─▒kt─▒n─▒n types her zaman parantez i├žine al─▒nmal─▒d─▒r, yani, (bool).

def example_function(arg1, arg2=4):
    """
    Example function that demonstrates Google-style docstrings.

    Args:
        arg1 (int): The first argument.
        arg2 (int): The second argument. Default value is 4.

    Returns:
        (bool): True if successful, False otherwise.

    Examples:
        >>> result = example_function(1, 2)  # returns False
    """
    if arg1 == arg2:
        return True
    return False

Bu ├Ârnekte hem Google tarz─▒ docstring hem de arg├╝man ve d├Ân├╝┼č tipi ipu├žlar─▒ g├Âsterilmektedir, ancak her ikisi de gerekli de─čildir; biri di─čeri olmadan da kullan─▒labilir.

def example_function(arg1: int, arg2: int = 4) -> bool:
    """
    Example function that demonstrates Google-style docstrings.

    Args:
        arg1: The first argument.
        arg2: The second argument. Default value is 4.

    Returns:
        True if successful, False otherwise.

    Examples:
        >>> result = example_function(1, 2)  # returns False
    """
    if arg1 == arg2:
        return True
    return False

Daha k├╝├ž├╝k veya daha basit i┼člevler, tek sat─▒rl─▒k bir belge dizisi kullanabilir. Not: Belge dizisi 3 ├žift t─▒rnak kullanmal─▒ ve b├╝y├╝k harfle ba┼člay─▒p nokta ile biten tam bir c├╝mle olmal─▒d─▒r.

def example_small_function(arg1: int, arg2: int = 4) -> bool:
    """Example function that demonstrates a single-line docstring."""
    return arg1 == arg2

GitHub Eylemleri CI Testleri

├çekme iste─činiz birle┼čtirilmeden ├Ânce, t├╝m GitHub Actions S├╝rekli Entegrasyon (CI) testleri ge├žmelidir. Bu testler, de─či┼čikliklerinizin projenin kalite standartlar─▒n─▒ kar┼č─▒lad─▒─č─▒ndan emin olmak i├žin linting, birim testleri ve di─čer kontrolleri i├žerir. GitHub Eylemlerinin ├ž─▒kt─▒s─▒n─▒ inceleyin ve varsa sorunlar─▒ giderin.

Hatalar─▒n Raporlanmas─▒

Projenin kalitesinin korunmas─▒nda ├žok ├Ânemli bir rol oynad─▒klar─▒ i├žin hata raporlar─▒n─▒ takdir ediyoruz. Hatalar─▒ bildirirken, Minimum Yeniden ├ťretilebilir ├ľrnek sa─člamak ├Ânemlidir: sorunu tekrarlayan a├ž─▒k, ├Âzl├╝ bir kod ├Ârne─či. Bu, hatan─▒n h─▒zl─▒ bir ┼čekilde tan─▒mlanmas─▒na ve ├ž├Âz├╝lmesine yard─▒mc─▒ olur.

Lisans

Ultralytics depolar─▒ i├žin GNU Affero Genel Kamu Lisans─▒ v3.0'─▒ (AGPL-3.0 ) benimser ve yaz─▒l─▒m geli┼čtirmede a├ž─▒kl─▒─č─▒, ┼čeffafl─▒─č─▒ ve i┼čbirli─čine dayal─▒ iyile┼čtirmeyi te┼čvik eder. Bu g├╝├žl├╝ copyleft lisans─▒, t├╝m kullan─▒c─▒lar─▒n ve geli┼čtiricilerin yaz─▒l─▒m─▒ kullanma, de─či┼čtirme ve payla┼čma ├Âzg├╝rl├╝─č├╝n├╝ korumas─▒n─▒ sa─člar. Herhangi bir iyile┼čtirmenin herkes taraf─▒ndan eri┼čilebilir kalmas─▒n─▒ sa─člayarak topluluk i┼čbirli─čini te┼čvik eder.

Kullan─▒c─▒lar─▒n ve geli┼čtiricilerin Ultralytics a├ž─▒k kaynak toplulu─čuna etkin ve etik bir ┼čekilde katk─▒da bulunabilmeleri i├žin AGPL-3.0 ┼čartlar─▒n─▒ ├Â─črenmeleri te┼čvik edilmektedir.

Sonu├ž

Ultralytics a├ž─▒k kaynakl─▒ YOLO projelerine katk─▒da bulunmaya g├Âsterdi─činiz ilgi i├žin te┼čekk├╝r ederiz. Kat─▒l─▒m─▒n─▒z, yaz─▒l─▒m─▒m─▒z─▒n gelece─čini ┼čekillendirmek ve bir yenilik ve i┼čbirli─či toplulu─čunu te┼čvik etmek i├žin ├žok ├Ânemlidir. ─░ster kodu geli┼čtiriyor, ister hatalar─▒ bildiriyor veya ├Âzellikler ├Âneriyor olun, katk─▒lar─▒n─▒z ├Ânemli bir etki yarat─▒r.

Fikirlerinizi eylemde g├Ârmek i├žin sab─▒rs─▒zlan─▒yoruz ve nesne alg─▒lama teknolojisini geli┼čtirmeye olan ba─čl─▒l─▒─č─▒n─▒z─▒ takdir ediyoruz. Bu heyecan verici a├ž─▒k kaynak yolculu─čunda birlikte b├╝y├╝meye ve yenilik yapmaya devam edelim. Mutlu kodlamalar! ­čÜÇ­čîč

SSS

Neden Ultralytics YOLO a├ž─▒k kaynak depolar─▒na katk─▒da bulunmal─▒y─▒m?

Ultralytics YOLO a├ž─▒k kaynak depolar─▒na katk─▒da bulunmak, yaz─▒l─▒m─▒n geli┼čtirilmesine yard─▒mc─▒ olarak t├╝m topluluk i├žin daha sa─člam ve zengin ├Âzelliklere sahip olmas─▒n─▒ sa─člar. Katk─▒lar kod geli┼čtirmeleri, hata d├╝zeltmeleri, dok├╝mantasyon iyile┼čtirmeleri ve yeni ├Âzellik uygulamalar─▒n─▒ i├žerebilir. Ayr─▒ca, katk─▒da bulunmak, di─čer yetenekli geli┼čtiriciler ve alandaki uzmanlarla i┼čbirli─či yapma ┼čans─▒ sunarak kendi becerilerinizi ve itibar─▒n─▒z─▒ art─▒r─▒r. Nas─▒l ba┼člayaca─č─▒n─▒z hakk─▒nda bilgi i├žin ├çekme ─░stekleri ile Katk─▒da Bulunma b├Âl├╝m├╝ne bak─▒n.

Ultralytics YOLO i├žin Kat─▒l─▒mc─▒ Lisans S├Âzle┼čmesini (CLA) nas─▒l imzalar─▒m?

Kat─▒l─▒mc─▒ Lisans S├Âzle┼čmesini (CLA) imzalamak i├žin, ├žekme iste─činizi g├Ânderdikten sonra CLA botu taraf─▒ndan sa─članan talimatlar─▒ izleyin. Bu, katk─▒lar─▒n─▒z─▒n AGPL-3.0 lisans─▒ alt─▒nda uygun ┼čekilde lisanslanmas─▒n─▒ ve a├ž─▒k kaynakl─▒ projenin yasal b├╝t├╝nl├╝─č├╝n├╝n korunmas─▒n─▒ sa─člayacakt─▒r. ├çekme iste─činize bahseden bir yorum ekleyin:

I have read the CLA Document and I sign the CLA

Daha fazla bilgi i├žin CLA ─░mzalama b├Âl├╝m├╝ne bak─▒n.

Google tarz─▒ dok├╝manlar nedir ve Ultralytics YOLO katk─▒lar─▒ i├žin neden gereklidir?

Google-tarz─▒ dok├╝manlar, fonksiyonlar ve s─▒n─▒flar i├žin a├ž─▒k ve ├Âzl├╝ dok├╝mantasyon sa─člayarak kodun okunabilirli─čini ve s├╝rd├╝r├╝lebilirli─čini art─▒r─▒r. Bu dok├╝manlar, fonksiyonun amac─▒n─▒, arg├╝manlar─▒n─▒ ve geri d├Ân├╝┼č de─čerlerini belirli bi├žimlendirme kurallar─▒yla ├Âzetler. Ultralytics YOLO adresine katk─▒da bulunurken, Google tarz─▒ dok├╝mantasyonlara ba─čl─▒ kalmak, eklemelerinizin anla┼č─▒l─▒r ve iyi belgelenmi┼č olmas─▒n─▒ sa─člar. ├ľrnekler ve y├Ânergeler i├žin Google-Style Docstrings b├Âl├╝m├╝n├╝ ziyaret edin.

De─či┼čikliklerimin GitHub Actions CI testlerini ge├žti─činden nas─▒l emin olabilirim?

├çekme iste─činiz birle┼čtirilmeden ├Ânce, t├╝m GitHub Actions S├╝rekli Entegrasyon (CI) testlerini ge├žmelidir. Bu testler, kodun projenin kalite standartlar─▒n─▒ kar┼č─▒lad─▒─č─▒ndan emin olmak i├žin linting, birim testleri ve di─čer kontrolleri i├žerir. GitHub Eylemlerinin ├ž─▒kt─▒s─▒n─▒ inceleyin ve sorunlar─▒ giderin. CI s├╝reci hakk─▒nda ayr─▒nt─▒l─▒ bilgi ve sorun giderme ipu├žlar─▒ i├žin GitHub Actions CI Testleri b├Âl├╝m├╝ne bak─▒n.

Ultralytics YOLO depolar─▒ndaki bir hatay─▒ nas─▒l bildirebilirim?

Bir hatay─▒ bildirmek i├žin, hata raporunuzla birlikte a├ž─▒k ve ├Âzl├╝ bir Minimum Tekrarlanabilir ├ľrnek sa─člay─▒n. Bu, geli┼čtiricilerin sorunu h─▒zla tan─▒mlamas─▒na ve d├╝zeltmesine yard─▒mc─▒ olur. ├ľrne─činizin asgari d├╝zeyde ancak sorunu tekrarlamak i├žin yeterli oldu─čundan emin olun. Hata bildirme ile ilgili daha ayr─▒nt─▒l─▒ ad─▒mlar i├žin Hata Bildirme b├Âl├╝m├╝ne bak─▒n.



Olu┼čturma 2023-11-12, G├╝ncelleme 2024-07-04
Yazarlar: glenn-jocher (8), UltralyticsAssistant (1)

Yorumlar