2. Getting Started 2. Önbilgi

We collected the data from GitHub API using a custom written software called OpenTR/CuttleCat . All the location related data is collected from the location field of the user profile. We went an extra mile to understand if the location is actually in Turkey. Verileri GitHub API'sinden OpenTR/CuttleCat isimli özel yazılan bir yazılım kullanarak topladık. Tüm konumla ilgili veriler, kullanıcı profili içindeki konum alanından toplanmıştır. Konumun gerçekten Türkiye'de olup olmadığını anlamak için ekstra bir çaba sarf ettik.

Collected data can be found in OpenTRFoundation/state-of-oss-contribution repository. Toplanan veriler, OpenTR/state-of-oss-contribution repository'sinde görülebilir.

3. Comparison with GitHub Innovation Graph data 3. GitHub Innovation Graph verileri ile karşılaştırma

GitHub's Innovation Graph is a great resource for understanding country specific GitHub usage. Its data is aggregated from GitHub network activity and data. GitHub'ın hazırladığı Innovation Graph isimli rapor, ülkelere özel GitHub kullanımını anlamak için harika bir kaynaktır. Verileri, GitHub ağ etkinliği ve verilerinden toplanmıştır.

GitHub is using some internal resources when building their Innovation Graph, which are not accessible to public. They don't need to use the location field user provided, as they have access to the IP address of the user and thus the location. GitHub uses the IP address to determine the country of the user as described in their datasheet. GitHub, Innovation Graph'ı oluştururken herkese açık olmayan bazı iç kaynakları kullanıyor. Kullanıcının IP adresine ve dolayısıyla konumuna erişebildikleri için, kullanıcının sağladığı konum alanını kullanmalarına gerek yok. GitHub, veri seti bilgilendirmesinde yazıldığı üzere, kullanıcının ülkesini belirlemek için IP adresini kullanıyor.

We compared our data with the data from GitHub Innovation Graph, and we understand that GitHub Innovation Graph data is more accurate, but it is less detailed. As they only provide aggregated data, the break down is very limited. For example, we cannot see the distribution of the users in Turkey per province. Similarly, we cannot see the number of active users or their contribution to open source projects. Verilerimizi GitHub Innovation Graph verileri ile karşılaştırdık ve GitHub Innovation Graph verilerinin daha doğru olduğunu, ancak daha az ayrıntılı olduğunu anladık. Yalnızca toplu veri sağladıkları için, verilen kırılımlar kısıtlı. Örneğin Türkiye'deki kullanıcıların il bazında dağılımını göremiyoruz. Benzer şekilde, aktif kullanıcıların sayısını veya açık kaynak projelerine katkılarını göremiyoruz.

For example, GitHub Innovation Graph data shows 1,317,401 users in Turkey as of Q1 2023, while we found around 110,000 users with a location field somewhere in Turkey. This is because the location field is a plain-text and optional input. Some users from Turkey might not have entered a location, or they might have written a location that we couldn't match with Turkey. GitHub Innovation Graph verileri, 2023'in birinci çeyreği itibariyle Türkiye'de 1.317.401 kullanıcı gösterirken, biz konum bilgisi Türkiye'de bir yer olarak girmiş olan yaklaşık 110.000 kullanıcı bulduk. Bu, konum alanının düz metin ve opsiyonel bir alan olması nedeniyledir. Türkiye'den bazı kullanıcılar bir konum yazmamış olabilir veya Türkiye ile eşleştiremediğimiz bir konum yazmış olabilir.

Considering the Weak Law of Large Numbers , readers can have very good approximations about the trends and changes. Also, although we probably cannot multiply every user count related number below with 13 (1.3M/110K ratio), readers can use this ratio to have a feeling about the number of users and open source contributors from Turkey. We did not use this ratio and simply show the numbers we found. Büyük Sayılar Yasası göz önüne alındığında, okuyucuların trendler ve değişiklikler hakkında çok iyi yaklaşımlar yapabileceğini düşünüyoruz. Ayrıca, muhtemelen kullanıcı sayısı ile ilgili aşağıdaki her sayıyı 13 ile çarpamayacaksak da (1,3 milyon / 110 bin oranı), okuyucular bu oranı Türkiye'deki GitHub kullanıcıları ve açık kaynak katkılarının sayısı hakkında bir fikir edinmek için kullanabilir. Biz bu oranı kullanmadık ve sadece bulduğumuz sayıları gösterdik.

4. Software people in Turkey from GitHub usage 4. Türkiye'deki yazılımcılar ve GitHub kullanımı

This section gives an overview of software industry in Turkey, with regard to GitHub usage. Bu bölüm, GitHub kullanımı açısından Türkiye'deki yazılım endüstrisine genel bir bakış sunmaktadır.

Yearly sign up numbers of GitHub users with a location somewhere in Turkey Türkiye'de bir yer olarak bir konum yazmış GitHub kullanıcılarının yıllık kayıt sayıları

Number of active GitHub users with location somewhere in Turkey Türkiye'de bir yer olarak bir konum yazmış aktif GitHub kullanıcılarının sayısı

5. What projects? 5. Hangi projeler?

OpenTR's mission is to increase the number of contributors from Turkey to open source projects. However, what are these projects? This section gives an overview of such projects. OpenTR'nin misyonu, Türkiye'den açık kaynak projelere katkıda bulunanların sayısını artırmaktır. Ancak, bu projeler hangileri? Bu bölüm, bu tür projelere bir genel bakış sunmaktadır.

Any public project on GitHub is open source by definition (as long as it has a OSS license). However, we want more contributors to work on some projects that we think have an impact. GitHub'daki herhangi bir public proje, tanım gereği açık kaynaktır (bir açık kaynak lisansı varsa). Ancak, daha fazla katılımcının etkili olduğunu düşündüğümüz bazı projelerde çalışmasını istiyoruz.

We call these projects focus projects. Bu projelere odak projeler diyoruz.

Criteria for focus projects can be seen in the next section. Odak projeler için kriterler bir sonraki bölümde görülebilir.

Projects vs organizations vs repositories Projeler vs organizasyonlar vs repository'ler

We use the term project in an abstract way to refer to a project such as Linux, Kubernetes, or React. We cannot tie a project to a repository or a GitHub organization, as some projects may have multiple repositories. Some projects may even have repositories under different organizations. Linux, Kubernetes veya React gibi bir projeden bahsederken, soyut bir şekilde proje terimini kullanıyoruz. Bir projeyi bir repository veya GitHub organizasyonuna bağlayamayız, çünkü bazı projelerin birden fazla repository'si olabilir. Bazı projeler, farklı organizasyonların altında bile repository'lere sahip olabilir.

For example Kubernetes has multiple repositories under the kubernetes organization, but it also has repositories under other organizations such as kubernetes-sigs. Conversely, the Linux project does not have an organization. Its main repository is the torvalds/linux repository. Örneğin Kubernetes, kubernetes organizasyonunun altında birden fazla repository'ye sahip, ancak kubernetes-sigs gibi diğer organizasyonların altında da repository'lere sahip. Bunun aksine, Linux projesinin bir organizasyonu yok. Ana repository'si torvalds/linux.

To make things simpler, we use the term focus organization to refer to an organization that has at least one repository that meets the criteria below. Similarly, we use the term focus repository to refer to a repository that meets another set of criteria below. İşleri sadeleştirmek için, aşağıdaki kriterleri karşılayan en az bir repository'si olan bir organizasyondan bahsetmek için odak organizasyon terimini kullanıyoruz. Benzer şekilde, aşağıdaki diğer kriterleri karşılayan bir repository'den bahsetmek için odak repository terimini kullanıyoruz.

OpenTR's goal in this report is to find the number of contributors to open source projects. It is not finding the number of open source repositories or organizations in general. So, when we check users from Turkey, we only check the users who contributed to any repository in a focus organization or to a focus repository. OpenTR'nin bu rapordaki amacı, açık kaynak projelerine katkıda bulunanların sayısını bulmaktır. Genel olarak açık kaynak repository'lerinin veya organizasyonlarının sayısını bulmak değildir. Bu nedenle, Türkiye'den kullanıcıları kontrol ettiğimizde, yalnızca bir odak organizasyonun herhangi bir repository'sine veya bir odak repository'ye katkıda bulunan kullanıcıların bilgilerini çekiyoruz.

Focus organizations Odak organizasyonlar

Contributions to any repositories under these organizations are counted as contributions to open source. Bu organizasyonların altındaki herhangi bir repository'ye yapılan katkılar, açık kaynağa yapılan katkılar olarak değerlendirilmiştir.

We only show the top 100 organizations the following word cloud. Aşağıdaki word cloud'da sadece ilk 100 organizasyonu gösteriyoruz.

Focus repositories outside organizations Organizasyon harici odak repository'ler

Similarly, contributions to any of these repositories that are not under any organization are counted as contributions to open source. Benzer şekilde, herhangi bir organizasyonun altında olmayan bu repository'lerin herhangi birine yapılan katkılar, açık kaynağa yapılan katkılar olarak değerlendirilmiştir.

We only show the top 50 repositories the following cloud. Aşağıdaki word cloud'da sadece ilk 50 repository'yi gösteriyoruz.

6. OSS Contributors from Turkey 6. Türkiye'den açık kaynağa katkıda bulunanlar

This section gives an overview of the contributors from Turkey to open source projects. Bu bölüm, Türkiye'den açık kaynak projelerine katkıda bulunanlara bir genel bakış sunmaktadır.

7. How we calculate the user scores? 7. Kullanıcı skorlarını nasıl hesaplıyoruz?

Finding a good balance between the number of contributions and the quality of contributions is not easy. We believe that the scoring system we came up with is a good balance. It is mostly done with a trial and error approach. Katkı sayısı ile katkı kalitesi arasında iyi bir denge bulmak kolay değil. Bulduğumuz skorlama sisteminin iyi bir denge olduğuna inanıyoruz. Bu skor sistemi, çoğunlukla deneme yanılma yaklaşımıyla üretildi.

In summary, user's score is the normalized sum of scores that are per-repository that's multiplied with a multiplier for contribution diversity. Özetle, kullanıcının skoru, repository başına skorların toplamının normalizasyonunun katkı çeşitliliği çarpanıyla çarpılmasıyla elde edilir.

$$userScore=$$ $$\sqrt{\begin{array}{r}\begin{array}{cc}& sumOfScores\\ & \times \\ & contribDiversityMultiplier\end{array}\end{array}}$$ $$userScore=\sqrt{sumOfScores\times contribDiversityMultiplier}$$

The contribution diversity multiplier, $contribDiversityMultiplier$, is obtained by finding the number of focus organizations the user contributed to. Since the number can be high, only 25% of its value is used. Katkı çeşitliliği çarpanı $contribDiversityMultiplier$, kullanıcının katkıda bulunduğu odak organizasyonların sayısının bulunmasıyla elde edilir. Bu sayı yüksek olabileceğinden, değerinin yalnızca %25'i kullanılır.

$$contribDiversityMultiplier=$$ $$(contributedFocusOrgs\times 25\mathrm{\%})+1$$ $$contribDiversityMultiplier=1+(contributedFocusOrgs\times 25\mathrm{\%})$$

For example, if a user contributed to 4 focus organizations, the multiplier is $2$. If a user contributed to 16 focus organizations, the multiplier is $5$. Örneğin, bir kullanıcı 4 odak organizasyona katkıda bulunduysa, çarpan $2$'dir. Bir kullanıcı 16 odak organizasyona katkıda bulunduysa, çarpan $5$'tir.

User's sum of scores, $sumOfScores$, is the sum of scores that are per-repository. The score per repository is calculated by multiplying the user's contribution score for that repository with a multiplier that's based on the repository's score. Kullanıcının skor toplamı $sumOfScores$, repository başına skorların toplamıdır. Repository başına skor, kullanıcının o repository için katkı skoru ile repository'nin skoruna dayalı bir çarpanın çarpılmasıyla hesaplanır.

$$sumOfScores=$$ $$\sum \left(\begin{array}{r}\begin{array}{cc}& userRepositoryContribScore\\ & \times \\ & (1+(repoScore\times 5\mathrm{\%}))\end{array}\end{array}\right)$$ $$sumOfScores=\sum (userRepositoryContribScore\times (1+(repoScore\times 5\mathrm{\%}))$$

User's contribution score for a repository, $userRepositoryContribScore$, is calculated by summing the contribution scores for each contribution type for that repository. The contribution score for each contribution type is calculated by multiplying the normalized contribution count with a coefficient that's different for each the contribution type. Kullanıcının bir repository için katkı skoru $userRepositoryContribScore$, o repository için her katkı türünde olan katkı skorlarının toplanmasıyla hesaplanır. Her katkı türü için katkı skoru, normalleştirilmiş katkı sayısının, katkı türüne göre farklı olan bir katsayıyla çarpılmasıyla hesaplanır.

$$userRepositoryContribScore=$$ $$\sum \left(\begin{array}{r}\begin{array}{cc}& \sqrt{contribCount}\\ & \times \\ & contribTypeCoef\end{array}\end{array}\right)$$ $$contribTypeCoef=$$ $$\{\begin{array}{ll}60,& \text{if Pull Request}\\ 30,& \text{if Pull Request Review}\\ 9,& \text{Issue}\\ 1,& \text{if Commit}\end{array}$$ $$userRepositoryContribScore=\sum (\sqrt{contribCount}\times contribTypeCoef)$$ $$contribTypeCoef=\{\begin{array}{ll}60,& \text{if Pull Request}\\ 30,& \text{if Pull Request Review}\\ 9,& \text{Issue}\\ 1,& \text{if Commit}\end{array}$$

For example a user has 100 pull requests for repository A which has a score of 100 and 10000 commits for repository B which has a score of 20. The score for repository A will be $(\sqrt{100}\times 60\times (1+(100\times 5\mathrm{\%}))$ = 3600 and the score for repository B will be $(\sqrt{10000}\times 1\times (1+(20\times 5\mathrm{\%}))$ = 200. Hence, $sumOfScores$ will be $3800$. Örneğin, bir kullanıcının 100 skorlu A repository'si için 100 pull request'i ve 20 skorlu B repository'si için 10000 commit'i var. A repository'si için skor $(\sqrt{100}\times 60\times (1+(100\times 5\mathrm{\%}))$ = 3600 ve B repository'si için skor $(\sqrt{10000}\times 1\times (1+(20\times 5\mathrm{\%}))$ = 200 olacaktır. Dolayısıyla, $sumOfScores$ $3800$ olacaktır.

We believe this is a good balance as it gives more weight to pull requests and pull request reviews compared to commits and issues. Also, it gives more weight to repositories that have a higher score. Bu hesabın, pull request ve pull request review'lara commit ve issue'lara göre daha fazla ağırlık verdiği için iyi bir denge olduğuna inanıyoruz. Ayrıca, daha yüksek skorlu repository'lere daha fazla ağırlık veriliyor.

The repository score, $repoScore$, is calculated by weighted summing the scores for each metric for that repository and then normalizing it. Also, an organization multiplier is applied to the score. Repository skoru $repoScore$, o repository için metriklerin ağırlıklı toplanması ve ardından normalleştirilmesiyle hesaplanır. Ayrıca, skora bir organizasyon çarpanı uygulanır.

$$repoScore=$$ $$\begin{gathered} \begin{array}{r}\begin{array}{cc}& \sqrt{ \\ {\displaystyle \frac{\begin{array}{rl}& (forks\times 5)+(stars\times 20)+\\ & (PRs\times 20)+(issues\times 40)+\\ & (watchers\times 10)+(discussions\times 5)\end{array}}{100}}}\\ & \times orgMultiplier\end{array}\end{array} \end{gathered}$$ $$repoScore=\sqrt{{\displaystyle \frac{\begin{array}{rl}& (forks\times 5)+(stars\times 20)+(PRs\times 20)+\\ & (issues\times 40)+(watchers\times 10)+(discussions\times 5)\end{array}}{100}}}\times orgMultiplier$$

As the numbers correlate (e.g. projects with more stars have other metrics higher as well), a normalization is done by square rooting the sum. Also, we want to give more weight to repositories that belong to an established organization. This is mostly the case for open source projects that are in a good shape. This is done by the $orgMultiplier$. Sayılar birbiriyle ilişkili olduğundan (örneğin, daha fazla star'a sahip projelerin diğer metrikleri de daha yüksektir), toplamın karekökü alınarak normalleştirme yapılır. Ayrıca, oturmuş bir organizasyona ait olan repository'lere daha fazla ağırlık vermek istiyoruz. Bu durum, çoğunlukla iyi durumda olan açık kaynak projeleri için geçerli. Bu da $orgMultiplier$ ile yapılmakta.

The organization multiplier, $orgMultiplier$, is calculated by finding the number of repositories of an organization that passed the criteria to be matched as a focus repository candidate. Organizasyon çarpanı $orgMultiplier$, bir organizasyonun odak repository adayı kriterlerini geçen repository sayısının bulunmasıyla hesaplanır.

$$orgMultiplier=$$ $$(\sqrt{matchedReposInOrg}\times 1\mathrm{\%})+1$$ $$orgMultiplier=1+(\sqrt{matchedReposInOrg}\times 1\mathrm{\%})$$

If the organization has 16 repositories that passed the criteria, the multiplier is $1.04$. If the organization has 256 repositories that passed the criteria, the multiplier is $1.16$. Eğer organizasyonun kriterleri geçen 16 repository'si varsa, çarpan $1.04$'tür. Eğer organizasyonun kriterleri geçen 256 repository'si varsa, çarpan $1.16$'dır.

8. OSS Contributor Companies 8. Açık kaynağa katkıda bulunan şirketler

This section gives an overview of the companies that contribute to open source from Turkey. Bu bölüm, Türkiye'den açık kaynağa katkıda bulunan şirketlere bir genel bakış sunmaktadır.

9. Organizations contributed to 9. Katkı yapılan organizasyonlar

This section gives an overview of the organizations that contributors from Turkey contributed to. Bu bölüm, Türkiye'den katkıda bulunanların katkıda bulunduğu organizasyonlara bir genel bakış sunmaktadır.

10. Take aways 10. Görüşler

• Contribute to Focus Projects Odak Projelere Katkıda Bulunun

  Change the "I open sourced my project" mindset to "I contribute to open source projects". "Projemin kaynağını açtım" düşüncesini "açık kaynak projelere katkıda bulunuyorum" düşüncesiyle değiştirin.

  Be part of something big! Contribute to open source projects and gain valuable experience. Seek mentorship, read OpenTR's guides , and join OpenTR community for support and guidance. Encourage your company to contribute to these projects and make a positive impact. Büyük bir şeyin parçası olun! Açık kaynak projelerine katkıda bulunun ve deneyim kazanın. Mentorluk arayın, OpenTR rehberlerini okuyun ve destek ile rehberlik için OpenTR topluluğuna katılın. Şirketinizi bu projelere katkıda bulunmaya teşvik edin ve olumlu bir etki yaratın.

  Why you should do that? Neden bunu yapmalısınız?
  • Improve your career by enhancing your skills and visibility globally. Becerilerinizi geliştirerek ve küresel olarak görünürlüğünüzü artırarak kariyerinizi ilerletin.
  • Help your company by contributing to your company's growth via impactful open source projects. Etkili açık kaynak projeleri aracılığıyla şirketinizin büyümesine katkıda bulunarak şirketinize yardımcı olun.
  • Help Turkey's software industry by being a driving force in advancing it. Türkiye'nin yazılım endüstrisinin ilerlemesine yardımcı olun.
  • Help projects you use by giving back to the projects that you rely on. Kullandığınız projelere geri verimde bulunarak yardımcı olun.
  Why your company should do that? Neden şirketiniz de bunu yapmalı?
  • Improve your company's brand by showing commitment to community and innovation. Şirketinizin topluluklara ve innovasyona olan bağlılığını göstererek, şirketinizin markasını geliştirin.
  • Improve your company's hiring by attracting top talent via making a name in open source. Açık kaynakta adınızı duyurun ve en iyi yetenekleri çekerek şirketinizin işe alımını geliştirin.
  • Improve your company's products by enhancing them through collaborative, community-driven development. İş birliği ve topluluk odaklı geliştirme ile şirketinizin ürünlerinizi iyileştirin.
• Set Your Location and Company on GitHub GitHub'ta Konumunuzu ve Şirketiniz Girin

  Make your presence known! Set your location on GitHub to Turkey or your province. Also make sure to update your company name on your GitHub profile. Varlığınızı bilinir hale getirin! GitHub'ta konumunuzu Türkiye veya ilinize ayarlayın. Ayrıca GitHub profilinizde şirket adınızı güncellediğinizden emin olun.

• Find out more Daha fazlasını öğrenin

  Check out OpenTR's website to learn more about OpenTR, open source and how you can contribute to open source. Açık kaynak hakkında, açık kaynağa nasıl katkıda bulunabileceğiniz hakkında ve OpenTR ile ilgili daha fazla bilgi edinmek için OpenTR'nin web sitesini ziyaret edin.