Kodlama Projelerinde Referanslama Neden Gereklidir?

Bir kod parçası, kütüphane veya açık kaynaklı yazılım kullanmak, çalışmanın temellerini başka bir çalışmanın üzerine inşa etmek anlamına gelir. Tıpkı makale, kitap ya da istatistiksel veri kullanımı gibi, bu tür yazılım bileşenlerinin de kaynak gösterilmesi gerekir. Aksi takdirde:

• İntihal (aşırma) riski doğar,

• Bilimsel çalışmanın güvenilirliği düşer,

• İlgili yazar ya da geliştiricinin emeği yok sayılmış olur.

Akademik bütünlük gereği, kullanılan her türlü kod, veri seti veya yazılım bileşeni açık ve sistematik şekilde Vancouver formatına göre referanslanmalıdır.

Vancouver Formatında Yazılım ve Kod Alıntısı Nasıl Yapılır?

Vancouver formatı, geleneksel olarak makale, kitap ve internet kaynakları için yapılandırılmış olsa da yazılım ve kodlama kaynaklarına da kolaylıkla uyarlanabilir. Önemli olan, kullanılan yazılımın yazar(lar)ı, adı, sürümü, yayın yılı ve erişim bağlantısı gibi temel bilgilerinin eksiksiz biçimde verilmesidir.

1. Kodlama Projesine Ait Yayın Varsa

Eğer kullanılan kodlama projesi bir akademik yayına sahipse, o yayının tam künyesi Vancouver biçiminde yazılır. Örnek:

1. Pedregosa F, Varoquaux G, Gramfort A, Michel V, Thirion B, Grisel O, et al. Scikit-learn: Machine learning in Python. J Mach Learn Res. 2011;12:2825–2830.

Kullanım:
“Veri madenciliği algoritmaları Scikit-learn [1] kütüphanesi ile uygulanmıştır.”

2. Kodlama Projesi Yalnızca GitHub Gibi Platformda Yayınlandıysa

GitHub gibi açık kaynaklı platformlarda paylaşılan kodlar için şu format kullanılır:

2. Chollet F. Keras [Internet]. GitHub; 2024 [cited 2025 Jul 15]. Available from: https://github.com/keras-team/keras

Kullanım:
“Derin öğrenme modelleri için Keras [2] kütüphanesi kullanılmıştır.”

3. Yazılım Paketleri (R, Python, MATLAB, vb.)

R, Python ya da MATLAB gibi dillerde kullanılan paketler için ilgili paketin yazar bilgisi, sürümü ve yayınlandığı platforma göre düzenleme yapılmalıdır.

3. Wickham H. ggplot2: Elegant graphics for data analysis. New York: Springer-Verlag; 2016.

Ya da:

4. Hunter JD. Matplotlib: A 2D graphics environment. Comput Sci Eng. 2007;9(3):90–95.

4. Kendi Geliştirilen Kodlar İçin

Araştırmacı kendi yazdığı kodu kullanmışsa ve bu kod başka bir yayında açıklanıyorsa, yine o yayına referans verilir. Kodun kendisine ait olduğu belirtilir.

5. Yılmaz O. Python ile geliştirilen ‘ML-DiseasePredictor’ algoritması bu çalışmaya özgüdür. Kod erişimi: https://github.com/oyilmaz/ml-diseasepredictor

Kodlama Projelerinde Vancouver Formatında Atıf Kullanım Alanları

Akademik kodlama projelerinde Vancouver stili aşağıdaki durumlarda aktif şekilde kullanılmalıdır:

• Kod parçalarının veya algoritmaların makalede tanıtılması,

• Sunumlarda veya proje posteri üzerinde kaynak gösterimi,

• Proje raporlarının referans bölümünde,

• GitHub, GitLab ya da Bitbucket sayfasında “Citing” (Atıf) kısmı için önerilen format olarak,

• Kod ile beraber sunulan teknik dökümanlarda.

Atıf Yaparken Dikkat Edilmesi Gereken Noktalar

• Sürüm bilgisi mutlaka belirtilmelidir.

• Erişim tarihi internet kaynaklarında eksik olmamalıdır.

• Tam bağlantı adresi (URL) verilmelidir.

• Eğer DOI (Digital Object Identifier) varsa, eklenmelidir.

• Yazılımlar için yayıncı veya geliştirici kişi/kurum mutlaka yazılmalıdır.

• Kodların çalıştığı ortam bilgisi (örneğin: Python 3.11) not edilmelidir.

Vancouver Stili İçin Kod Yorumlarına Alıntı Eklemek

Kod dosyalarının içine yorum satırı (comment) olarak da kaynak bilgisi eklenmelidir. Bu, özellikle açık kaynak dünyasında şeffaflık sağlar:

# Bu kod, sklearn.linear_model içindeki LogisticRegression modeline dayanmaktadır.
# Kaynak: Pedregosa F, et al. J Mach Learn Res. 2011;12:2825–2830.

Bu tarz yorumlar, kodun bilimsel dayanağını artırır ve akademik etikten ödün vermeden paylaşım yapma olanağı sağlar.

Akademik Kodlama Projelerinde Vancouver Formatı ile Hızlı Kütüphane Oluşturma

Çoğu yazılım projesinde kullanılan kütüphaneler, requirements.txt veya environment.yml dosyasıyla listelenir. Bu dosyadaki her bir paketin referans bilgisi oluşturularak, tek bir kaynak listesi Vancouver formatına göre aşağıdaki gibi hazırlanabilir:

6. NumPy Developers. NumPy [Internet]. 2024 [cited 2025 Jul 20]. Available from: https://numpy.org/
7. Pandas development team. pandas-dev/pandas: Pandas [Internet]. Zenodo; 2024. https://doi.org/10.5281/zenodo.3509134
8. Virtanen P, et al. SciPy 1.0: fundamental algorithms for scientific computing in Python. Nat Methods. 2020;17:261–272.

Kodlama Projesi Üzerine Akademik Makale Hazırlayanlar İçin Tavsiyeler

• Vancouver formatına uygun referans listesi hazırlamayı makalenin başından planlayın.

• Kullandığınız tüm dış yazılımların kaynaklarını sistemli olarak toplayın.

• Eğer bir kod bloğunu başka bir araştırmadan doğrudan aldıysanız, hem metin içinde hem de kod satırında bunu belirtin.

• Çalışmanızı açık erişimli bir dergide yayınlıyorsanız, referans şablonunun Vancouver formatına uyduğundan emin olun.

• Projenizi GitHub gibi bir platformda yayınlıyorsanız, README dosyasına da referans listesini ekleyin.

Sonuç

Akademik kodlama projelerinde Vancouver referanslama stili, şeffaflık, güvenilirlik ve akademik etik açısından vazgeçilmezdir. Kodlar ve yazılımlar da birer bilimsel katkı olduğundan, makalelerde olduğu gibi alıntılanmaları gerekir. Vancouver formatı, yazılım temelli araştırmalarda bu ihtiyaca net ve sistematik bir yanıt sunar. Geliştiriciler, araştırmacılar ve akademisyenler, çalışmalarına entegre ettikleri her yazılım bileşeni için doğru kaynak gösterimi yaparak hem kendi bilimsel duruşlarını güçlendirir hem de bilginin izlenebilirliğini sağlar. Özellikle açık kaynaklı projelerde bu disiplinin benimsenmesi, hem topluluğun etik anlayışını pekiştirir hem de projelerin akademik kabul edilebilirliğini artırır. Sonuç olarak, Vancouver atıf stiliyle düzenlenen referanslar, sadece bir formalite değil, bilimsel bir sorumluluğun yerine getirilmesidir.

Akademi Delisi, eğitim ve akademik destek alanında kapsamlı hizmetler sunan öncü bir platformdur. Öğrencilerin akademik başarılarına yön verirken, onları bilgiyle buluşturmayı ve potansiyellerini en üst düzeye çıkarmayı amaç edinmiş bir ekibiz. Sitemiz bünyesinde ödevlerden projelere, tezlerden makalelere kadar geniş bir yelpazede destek sağlıyoruz. Alanında uzman yazarlarımız, öğrencilere özgün içerikler sunarken, aynı zamanda onlara araştırma, analiz ve yazım konularında rehberlik ederek kendilerini geliştirmelerine yardımcı oluyor.

Akademik hayatın zorluklarıyla başa çıkmak artık daha kolay. Akademi Delisi olarak, öğrencilere sadece ödevlerinde değil, aynı zamanda araştırma projelerinde, tez çalışmalarında ve diğer akademik gereksinimlerinde de destek sağlıyoruz. Sunduğumuz kaliteli hizmetler sayesinde öğrenciler zamanlarını daha verimli bir şekilde kullanabilirler. Uzman ekibimiz, her bir öğrencinin ihtiyaçlarına özel çözümler üreterek, onların akademik hedeflerine ulaşmalarına katkı sağlar.

Gelişmiş kaynaklara erişimden akademik yazım kurallarına, araştırma yöntemlerinden kaynakça oluşturmaya kadar her aşamada öğrencilere destek sunan Akademi Delisi, eğitimde yeni bir perspektif sunuyor. Amacımız, öğrencilere sadece geçici çözümler değil, aynı zamanda uzun vadeli öğrenme ve başarıya giden yolda rehberlik etmektir.

The post Akademik Kodlama Projelerinde Vancouver Referanslama first appeared on Akademi Delisi (Tez Yaptırma).