\n Yaz\u0131l\u0131m d\u00fcnyas\u0131na ad\u0131m atmak, \u00f6zellikle de a\u00e7\u0131k kaynak projelerine katk\u0131da bulunmak heyecan verici bir yolculuktur. Ancak ilk katk\u0131y\u0131 yapmak, yani ilk “Pull Request”inizi (PR) g\u00f6ndermek, bir\u00e7ok geli\u015ftirici i\u00e7in g\u00f6z korkutucu olabilir. Bu noktada, a\u00e7\u0131k kaynak projelerinde “hafif” ve “\u00e7\u00f6z\u00fclebilir” sorunlar\u0131 bulup, bunlar\u0131 k\u00fc\u00e7\u00fck ve y\u00f6netilebilir par\u00e7alara ay\u0131rarak ilk PR’\u0131n\u0131z\u0131 alman\u0131z\u0131 sa\u011flayacak bir yard\u0131mc\u0131ya ne dersiniz? \u0130\u015fte size “OSS Buddy” ad\u0131n\u0131 verdi\u011fimiz, tam da bu ama\u00e7la tasarlanm\u0131\u015f yerel bir yakla\u015f\u0131mdan bahsedece\u011fiz. Bu makalede, OSS Buddy’nin ne oldu\u011funu, neden \u00f6nemli oldu\u011funu ve nas\u0131l kullan\u0131labilece\u011fini ad\u0131m ad\u0131m inceleyece\u011fiz.\n <\/p>\n
\n OSS Buddy, ad\u0131ndan da anla\u015f\u0131laca\u011f\u0131 gibi, a\u00e7\u0131k kaynak d\u00fcnyas\u0131nda bir “dost” g\u00f6revi g\u00f6r\u00fcr. \u00d6zellikle yaz\u0131l\u0131m geli\u015ftirme yolculu\u011funun ba\u015f\u0131ndaki, ilk a\u00e7\u0131k kaynak katk\u0131s\u0131n\u0131 yapmak isteyen geli\u015ftiricilere odaklan\u0131r. Temel felsefesi basittir: B\u00fcy\u00fck ve karma\u015f\u0131k sorunlar yerine, hafta sonu projesi olarak rahatl\u0131kla tamamlanabilecek, “k\u00fc\u00e7\u00fck” ve “belirli” g\u00f6revleri tespit etmek. Bu g\u00f6revler genellikle hata d\u00fczeltmeleri, dok\u00fcmantasyon g\u00fcncellemeleri, k\u00fc\u00e7\u00fck \u00f6zellik eklemeleri veya mevcut kodun iyile\u015ftirilmesi gibi i\u015flerdir. Bu sayede, yeni ba\u015flayanlar hem kodlama becerilerini pratik etme hem de ger\u00e7ek d\u00fcnya projelerine de\u011fer katma f\u0131rsat\u0131 bulurlar.\n <\/p>\n
\n Peki, neden bu kadar k\u00fc\u00e7\u00fck g\u00f6revlere odaklanmak \u00f6nemli? \u00d6ncelikle, b\u00fcy\u00fck projelere ilk katk\u0131y\u0131 yapmaya \u00e7al\u0131\u015f\u0131rken kar\u015f\u0131la\u015f\u0131lan karma\u015f\u0131kl\u0131k, motivasyon kayb\u0131na yol a\u00e7abilir. Bir hata ay\u0131klama s\u00fcreci bile, projenin genel mimarisini anlamadan olduk\u00e7a zorlay\u0131c\u0131 olabilir. OSS Buddy bu engeli a\u015fmaya yard\u0131mc\u0131 olur. K\u00fc\u00e7\u00fck bir g\u00f6revi ba\u015far\u0131yla tamamlamak, geli\u015ftiriciye hem \u00f6zg\u00fcven kazand\u0131r\u0131r hem de projenin i\u015fleyi\u015fi hakk\u0131nda temel bir anlay\u0131\u015f geli\u015ftirme imkan\u0131 sunar. Bu, bir maraton ko\u015fucusunun ilk \u00f6nce k\u0131sa mesafeler ko\u015farak antrenman yapmas\u0131na benzer.\n <\/p>\n
\n Ayr\u0131ca, a\u00e7\u0131k kaynak projelerinin s\u00fcrd\u00fcr\u00fclebilirli\u011fi i\u00e7in s\u00fcrekli bir katk\u0131 ak\u0131\u015f\u0131 gereklidir. Ancak bu katk\u0131lar\u0131n her zaman b\u00fcy\u00fck \u00f6zellikler olmas\u0131 gerekmez. Dok\u00fcmantasyon eksikliklerini gidermek, k\u00fc\u00e7\u00fck hatalar\u0131 d\u00fczeltmek veya test senaryolar\u0131n\u0131 iyile\u015ftirmek gibi “bak\u0131m” i\u015fleri de projenin sa\u011fl\u0131\u011f\u0131 i\u00e7in hayati \u00f6neme sahiptir. OSS Buddy, bu t\u00fcr “k\u00fc\u00e7\u00fck ama \u00f6nemli” g\u00f6revleri belirginle\u015ftirerek, hem katk\u0131da bulunmak isteyenleri motive eder hem de proje bak\u0131m\u0131na destek olur. Yerel ekosistemimizde de bu t\u00fcr bir yakla\u015f\u0131ma b\u00fcy\u00fck ihtiya\u00e7 var. Bir\u00e7ok yerel yaz\u0131l\u0131m \u015firketi ve toplulu\u011fu, a\u00e7\u0131k kaynak projelerine katk\u0131da bulunmak istiyor ancak nereden ba\u015flayaca\u011f\u0131n\u0131 bilemiyor. OSS Buddy, bu bo\u015flu\u011fu doldurarak, yerel geli\u015ftiricilerin k\u00fcresel a\u00e7\u0131k kaynak topluluklar\u0131na entegrasyonunu kolayla\u015ft\u0131rabilir.\n <\/p>\n
\n OSS Buddy’nin temel amac\u0131, sizin veya kuzeninizin gibi ilk katk\u0131s\u0131n\u0131 yapmaya haz\u0131rlanan geli\u015ftiricilerin, karma\u015f\u0131k s\u00fcre\u00e7lerde kaybolmadan, somut bir ba\u015far\u0131 elde etmesini sa\u011flamakt\u0131r. Bu s\u00fcre\u00e7, dikkatli bir planlama ve do\u011fru ara\u00e7lar\u0131n kullan\u0131m\u0131yla olduk\u00e7a basitle\u015ftirilebilir. \u0130lk olarak, katk\u0131da bulunmak istedi\u011finiz a\u00e7\u0131k kaynak projesini se\u00e7melisiniz. Bu se\u00e7imde, ilgi alanlar\u0131n\u0131z, kulland\u0131\u011f\u0131n\u0131z teknolojiler ve projenin topluluk yap\u0131s\u0131 gibi fakt\u00f6rler rol oynamal\u0131d\u0131r. \u00d6rne\u011fin, e\u011fer web geli\u015ftirme ile ilgileniyorsan\u0131z, pop\u00fcler bir JavaScript k\u00fct\u00fcphanesinin veya bir CMS (\u0130\u00e7erik Y\u00f6netim Sistemi) projesinin a\u00e7\u0131k kaynak koduna g\u00f6z atabilirsiniz.\n <\/p>\n
\n Proje se\u00e7ildikten sonra, “sorunlar” veya “issues” b\u00f6l\u00fcm\u00fcne odaklanmal\u0131s\u0131n\u0131z. GitHub, GitLab gibi platformlarda bu b\u00f6l\u00fcm, proje geli\u015ftiricilerinin tart\u0131\u015fma ba\u015flatt\u0131\u011f\u0131 ve \u00e7\u00f6z\u00fclmesi gereken g\u00f6revleri listeledi\u011fi yerdir. \u0130\u015fte OSS Buddy’nin devreye girdi\u011fi nokta buras\u0131d\u0131r. Bu sorunlar listesini tararken, a\u015fa\u011f\u0131daki kriterlere dikkat edin:\n <\/p>\n
\n Uygun bir sorun buldu\u011funuzda, hemen kodlamaya dalmadan \u00f6nce, projenin geli\u015ftirme ortam\u0131n\u0131 kurman\u0131z gerekir. Bu genellikle projenin README dosyas\u0131nda veya CONTRIBUTING.md dosyas\u0131nda detayl\u0131 olarak a\u00e7\u0131klan\u0131r. Geli\u015ftirme ortam\u0131n\u0131 kurmak, projenin kodunu yerel bilgisayar\u0131n\u0131za indirip, gerekli ba\u011f\u0131ml\u0131l\u0131klar\u0131 (dependencies) y\u00fcklemeyi i\u00e7erir. Bu ad\u0131mda tak\u0131l\u0131rsan\u0131z, endi\u015felenmeyin! Projenin tart\u0131\u015fma forumlar\u0131na veya sohbet odalar\u0131na (Slack, Discord gibi) sorunuzu sormaktan \u00e7ekinmeyin.\n <\/p>\n
\n Ortam kurulduktan sonra, se\u00e7ti\u011finiz sorunu \u00e7\u00f6zmek i\u00e7in kod \u00fczerinde \u00e7al\u0131\u015fmaya ba\u015flayabilirsiniz. De\u011fi\u015fikliklerinizi yaparken, projenin kodlama standartlar\u0131na (coding style) uymaya \u00f6zen g\u00f6sterin. E\u011fer emin de\u011filseniz, projenin mevcut kodlar\u0131na bakarak ipu\u00e7lar\u0131 alabilirsiniz. De\u011fi\u015fikliklerinizi tamamlad\u0131ktan sonra, bunlar\u0131 test etmeyi unutmay\u0131n. E\u011fer proje i\u00e7in otomatik testler (unit tests, integration tests) varsa, bunlar\u0131 \u00e7al\u0131\u015ft\u0131rman\u0131z \u00f6nemlidir. Kendi ekledi\u011finiz testler varsa, bunlar\u0131 da dahil edin.\n <\/p>\n
\n Son olarak, de\u011fi\u015fikliklerinizi bir “commit” (de\u011fi\u015fiklik kayd\u0131) haline getirin ve bunu kendi “fork”lad\u0131\u011f\u0131n\u0131z (kopyalad\u0131\u011f\u0131n\u0131z) proje deposuna g\u00f6nderin. Ard\u0131ndan, orijinal projeye bir “Pull Request” (PR) olu\u015fturun. PR’\u0131n\u0131zda, neyi \u00e7\u00f6zd\u00fc\u011f\u00fcn\u00fcz\u00fc, nas\u0131l \u00e7\u00f6zd\u00fc\u011f\u00fcn\u00fcz\u00fc ve neden bu \u00e7\u00f6z\u00fcm\u00fc se\u00e7ti\u011finizi a\u00e7\u0131k\u00e7a belirtin. Bu, proje y\u00f6neticilerinin (maintainers) katk\u0131n\u0131z\u0131 anlamas\u0131na ve de\u011ferlendirmesine yard\u0131mc\u0131 olacakt\u0131r. PR’\u0131n\u0131z incelendikten sonra, olas\u0131 geri bildirimlere (feedback) a\u00e7\u0131k olun ve gerekli d\u00fczeltmeleri yapmaktan \u00e7ekinmeyin. Bu s\u00fcre\u00e7, ilk PR’\u0131n\u0131z\u0131 alman\u0131n en \u00f6nemli ad\u0131mlar\u0131ndan biridir.\n <\/p>\n
\n Bu b\u00f6l\u00fcmde, “BlogEngine” ad\u0131nda hayali bir a\u00e7\u0131k kaynak blog platformu projesini ele alaca\u011f\u0131z. Kuzenim Ay\u015fe, web geli\u015ftirme alan\u0131nda yeni ve ilk a\u00e7\u0131k kaynak katk\u0131s\u0131n\u0131 yapmak istiyor. OSS Buddy yakla\u015f\u0131m\u0131n\u0131 kullanarak, Ay\u015fe’nin ilk PR’\u0131n\u0131 nas\u0131l alabilece\u011fini inceleyelim.\n <\/p>\n
\n Ad\u0131m 1: Proje Se\u00e7imi ve Sorun Tespiti<\/strong> \n Bu sorun, Ay\u015fe i\u00e7in ideal \u00e7\u00fcnk\u00fc:\n <\/p>\n \n Ay\u015fe, sorunun alt\u0131na yorum yaparak, bu g\u00f6revi \u00fcstlenmek istedi\u011fini belirtiyor. Proje y\u00f6neticisi (maintainer) olumlu yan\u0131t veriyor ve sorunun detaylar\u0131n\u0131 biraz daha a\u00e7\u0131kl\u0131yor.\n <\/p>\n \n Ad\u0131m 2: Geli\u015ftirme Ortam\u0131n\u0131n Kurulumu<\/strong> \n Ad\u0131m 3: Kod \u00dczerinde \u00c7al\u0131\u015fma<\/strong> \n Ayr\u0131ca, projenin kodlama standartlar\u0131n\u0131 kontrol ediyor. E\u011fer kodlama stili farkl\u0131ysa, otomatik bir formatlay\u0131c\u0131 (PHP-CS-Fixer gibi) kullanarak kodunu d\u00fczenliyor.\n <\/p>\n \n Ad\u0131m 4: Test Etme ve Commit Olu\u015fturma<\/strong> \n De\u011fi\u015fikliklerini bir commit mesaj\u0131yla kaydediyor: \n Ad\u0131m 5: Fork ve Pull Request Olu\u015fturma<\/strong> \n Birka\u00e7 g\u00fcn sonra, proje y\u00f6neticisi Ay\u015fe’nin PR’\u0131n\u0131 inceliyor ve k\u00fc\u00e7\u00fck bir stil de\u011fi\u015fikli\u011fi \u00f6neriyor. Ay\u015fe bu \u00f6neriyi dikkate alarak kodunu g\u00fcncelliyor ve PR’\u0131n\u0131 yeniden g\u00f6nderiyor. Sonunda, PR’\u0131 onaylan\u0131yor ve “merged” (birle\u015ftiriliyor)! Ay\u015fe, ilk a\u00e7\u0131k kaynak PR’\u0131n\u0131 ba\u015far\u0131yla alm\u0131\u015f oluyor. Bu, ona b\u00fcy\u00fck bir motivasyon sa\u011fl\u0131yor ve gelecekte daha karma\u015f\u0131k g\u00f6revlere ad\u0131m atmas\u0131 i\u00e7in zemin haz\u0131rl\u0131yor.\n <\/p>\n \n OSS Buddy yakla\u015f\u0131m\u0131n\u0131n ba\u015far\u0131s\u0131, do\u011fru t\u00fcrde sorunlar\u0131 belirlemekte yatar. Sadece “kolay” etiketli olmak de\u011fil, ayn\u0131 zamanda projenin genel yap\u0131s\u0131n\u0131 anlamak i\u00e7in iyi bir ba\u015flang\u0131\u00e7 noktas\u0131 sunan sorunlar tercih edilmelidir. Bu t\u00fcr sorunlar genellikle a\u015fa\u011f\u0131daki kategorilere girer:\n <\/p>\n \n A\u00e7\u0131k kaynak projelerinin en \u00e7ok ihmal edilen ama en kritik y\u00f6nlerinden biri dok\u00fcmantasyondur. Yanl\u0131\u015f, eksik veya g\u00fcncel olmayan dok\u00fcmantasyon, yeni kullan\u0131c\u0131lar\u0131n projeyi anlamas\u0131n\u0131 ve kullanmas\u0131n\u0131 zorla\u015ft\u0131r\u0131r. OSS Buddy i\u00e7in ideal sorunlar \u015funlard\u0131r:\n <\/p>\n \n Bu t\u00fcr g\u00f6revler, genellikle kodlama becerisi gerektirmez ancak projenin kalitesini art\u0131r\u0131r. Yeni ba\u015flayanlar i\u00e7in, projenin dilini ve terminolojisini \u00f6\u011frenmek i\u00e7in harika bir yoldur.\n <\/p>\n \n Her yaz\u0131l\u0131m projesinde hatalar bulunur. OSS Buddy, bu hatalardan “k\u00fc\u00e7\u00fck” ve “izole” olanlar\u0131n\u0131 hedefler. Bir hata, projenin ana i\u015flevselli\u011fini bozmayan, belirli bir senaryoda ortaya \u00e7\u0131kan ve \u00e7\u00f6z\u00fcm\u00fc i\u00e7in sadece birka\u00e7 sat\u0131r kod de\u011fi\u015fikli\u011fi gerektiren bir hata olmal\u0131d\u0131r.\n <\/p>\n \n Bu t\u00fcr hatalar\u0131 bulmak i\u00e7in genellikle projenin “Issues” b\u00f6l\u00fcm\u00fcnde “bug” etiketiyle filtrelenmi\u015f sorunlara bak\u0131l\u0131r. E\u011fer sorunun a\u00e7\u0131klamas\u0131 karma\u015f\u0131ksa veya birden fazla bile\u015feni etkiliyorsa, bu ilk PR i\u00e7in uygun olmayabilir.\n <\/p>\n \n Bazen projeler, mevcut i\u015flevselli\u011fi biraz daha iyi hale getirecek k\u00fc\u00e7\u00fck eklemeler veya iyile\u015ftirmeler talep eder. Bunlar, genellikle b\u00fcy\u00fck bir \u00f6zellik geli\u015ftirmenin par\u00e7as\u0131 olmayan, ba\u011f\u0131ms\u0131z ve basit geli\u015ftirmelerdir.\n <\/p>\n \n Bu t\u00fcr g\u00f6revler, genellikle “enhancement” veya “feature request” etiketleriyle i\u015faretlenir. Ancak, OSS Buddy ba\u011flam\u0131nda, bu “feature”lar\u0131n ger\u00e7ekten de “k\u00fc\u00e7\u00fck” oldu\u011fundan emin olmak \u00f6nemlidir.\n <\/p>\n \n Testler, yaz\u0131l\u0131m\u0131n g\u00fcvenilirli\u011fini sa\u011flamak i\u00e7in hayati \u00f6neme sahiptir. Projeler genellikle test kapsam\u0131n\u0131 geni\u015fletmek i\u00e7in yeni test senaryolar\u0131 ister.\n <\/p>\n \n Test yazmak, projenin nas\u0131l \u00e7al\u0131\u015ft\u0131\u011f\u0131n\u0131 anlamak i\u00e7in harika bir yoldur ve genellikle mevcut kodun anla\u015f\u0131lmas\u0131n\u0131 gerektirir.\n <\/p>\n \n Bu kategorilerdeki sorunlar\u0131 belirlerken, projenin \n OSS Buddy yakla\u015f\u0131m\u0131n\u0131n sadece k\u00fcresel projeler i\u00e7in de\u011fil, yerel yaz\u0131l\u0131m ekosistemimiz i\u00e7in de ne kadar de\u011ferli olabilece\u011fini vurgulamak gerekir. T\u00fcrkiye’de bir\u00e7ok yetenekli geli\u015ftirici var ve bu yeteneklerin a\u00e7\u0131k kaynak d\u00fcnyas\u0131na kazand\u0131r\u0131lmas\u0131, hem bireysel geli\u015fimleri hem de yerel teknoloji ekosisteminin b\u00fcy\u00fcmesi a\u00e7\u0131s\u0131ndan b\u00fcy\u00fck \u00f6nem ta\u015f\u0131yor.\n <\/p>\n \n Yerel topluluklar, \u00fcniversite kul\u00fcpleri veya teknoloji \u015firketleri, OSS Buddy’yi kendi projeleri i\u00e7in bir “giri\u015f noktas\u0131” olarak kullanabilirler. \u00d6rne\u011fin, bir \u00fcniversite yaz\u0131l\u0131m kul\u00fcb\u00fc, kendi b\u00fcnyesinde geli\u015ftirdi\u011fi veya destekledi\u011fi a\u00e7\u0131k kaynak projeler i\u00e7in “OSS Buddy” program\u0131 ba\u015flatabilir. Bu program kapsam\u0131nda, yeni ba\u015flayan \u00f6\u011frencilere y\u00f6nelik, yukar\u0131da bahsedilen t\u00fcrde k\u00fc\u00e7\u00fck ve y\u00f6netilebilir g\u00f6revler belirlenir. \u00d6\u011frenciler bu g\u00f6revleri tamamlad\u0131k\u00e7a, hem pratik deneyim kazan\u0131r hem de ilk PR’lar\u0131n\u0131 alarak motivasyonlar\u0131n\u0131 art\u0131r\u0131rlar.\n <\/p>\n \n Teknoloji \u015firketleri de bu yakla\u015f\u0131m\u0131 benimseyebilir. Bir \u015firket, kendi geli\u015ftirdi\u011fi a\u00e7\u0131k kaynakl\u0131 k\u00fct\u00fcphaneler veya ara\u00e7lar i\u00e7in “OSS Buddy” etiketli sorunlar olu\u015fturabilir. Bu, hem \u015firketin projelerinin topluluk taraf\u0131ndan daha fazla benimsenmesini sa\u011flar hem de potansiyel yeni yeteneklerin \u015firkete \u00e7ekilmesine yard\u0131mc\u0131 olur. Ayr\u0131ca, \u015firket \u00e7al\u0131\u015fanlar\u0131 da bu t\u00fcr g\u00f6revlere katk\u0131da bulunarak a\u00e7\u0131k kaynak topluluklar\u0131na destek olabilirler.\n <\/p>\n \n Bu yakla\u015f\u0131m\u0131n ba\u015far\u0131s\u0131 i\u00e7in birka\u00e7 \u00f6nemli nokta \u015funlard\u0131r:\n <\/p>\n \n OSS Buddy, sadece bir ara\u00e7 de\u011fil, ayn\u0131 zamanda a\u00e7\u0131k kaynak d\u00fcnyas\u0131na giri\u015fin daha kapsay\u0131c\u0131 ve motive edici hale getirilmesi i\u00e7in bir felsefedir. Yerel ekosistemimizde bu felsefenin yayg\u0131nla\u015fmas\u0131, daha fazla geli\u015ftiricinin a\u00e7\u0131k kaynak projelerine katk\u0131da bulunmas\u0131n\u0131 sa\u011flayacakt\u0131r.\n <\/p>\n \n OSS Buddy, a\u00e7\u0131k kaynak d\u00fcnyas\u0131na ad\u0131m atmak isteyen herkes i\u00e7in g\u00fc\u00e7l\u00fc bir yard\u0131mc\u0131d\u0131r. K\u00fc\u00e7\u00fck, y\u00f6netilebilir sorunlar\u0131 hedefleyerek, ilk PR’\u0131n\u0131z\u0131 alman\u0131n g\u00f6z korkutucu s\u00fcrecini basitle\u015ftirir ve size hem \u00f6zg\u00fcven hem de pratik deneyim kazand\u0131r\u0131r. Dok\u00fcmantasyon d\u00fczeltmelerinden k\u00fc\u00e7\u00fck hata ay\u0131klamalara kadar geni\u015f bir yelpazede g\u00f6revler bulmak m\u00fcmk\u00fcnd\u00fcr. \u00d6nemli olan, do\u011fru projeyi se\u00e7mek, geli\u015ftirme ortam\u0131n\u0131 kurmak, dikkatli kodlama yapmak ve en \u00f6nemlisi, sab\u0131rl\u0131 ve azimli olmakt\u0131r. Yerel ekosistemimizde de bu yakla\u015f\u0131m\u0131 benimseyerek, daha fazla geli\u015ftiriciyi a\u00e7\u0131k kaynak topluluklar\u0131na dahil edebilir ve hep birlikte daha g\u00fc\u00e7l\u00fc bir teknoloji ekosistemi olu\u015fturabiliriz. Unutmay\u0131n, her b\u00fcy\u00fck yolculuk k\u00fc\u00e7\u00fck bir ad\u0131mla ba\u015flar ve ilk PR’\u0131n\u0131z da bu yolculu\u011fun en \u00f6nemli ad\u0131mlar\u0131ndan biridir.\n <\/p>\n #A\u00e7\u0131kKaynak #Yaz\u0131l\u0131mGeli\u015ftirme #OSSBuddy #\u0130lkPR #Teknoloji<\/p>\n
\n Ay\u015fe, PHP ve Laravel framework’\u00fc ile ilgilendi\u011fi i\u00e7in, BlogEngine projesini se\u00e7iyor. GitHub’daki BlogEngine deposuna gidiyor ve “Issues” (Sorunlar) sekmesine t\u0131kl\u0131yor. “good first issue” ve “beginner friendly” etiketlerini filtreliyor. Kar\u015f\u0131s\u0131na \u00e7\u0131kan sorunlardan biri dikkatini \u00e7ekiyor: “Kullan\u0131c\u0131 profili sayfas\u0131nda ‘E-posta Adresi’ alan\u0131 eksik g\u00f6r\u00fcn\u00fcyor.”\n <\/p>\n\n
\n Ay\u015fe, BlogEngine’in README dosyas\u0131ndaki talimatlar\u0131 izleyerek yerel geli\u015ftirme ortam\u0131n\u0131 kuruyor. Bu, XAMPP (veya benzeri bir web sunucusu), Composer (PHP paket y\u00f6neticisi) ve Git’in kurulu olmas\u0131n\u0131 gerektiriyor. Kod deposunu klonluyor, ba\u011f\u0131ml\u0131l\u0131klar\u0131 composer install<\/code> komutuyla y\u00fckl\u00fcyor ve bir .env<\/code> dosyas\u0131 olu\u015fturup veritaban\u0131 ba\u011flant\u0131 bilgilerini ayarl\u0131yor. Yerel bir veritaban\u0131 kurup, gerekli migrasyonlar\u0131 (php artisan migrate<\/code>) \u00e7al\u0131\u015ft\u0131r\u0131yor.\n <\/p>\n
\n Ay\u015fe, kullan\u0131c\u0131 profili sayfas\u0131n\u0131n ilgili Blade \u015fablonunu (view) buluyor. resources\/views\/profile\/show.blade.php<\/code> gibi bir dosyada, e-posta adresi i\u00e7in bir sat\u0131r eklemesi gerekti\u011fini anl\u0131yor. Controller’da (kontrolc\u00fc) ilgili veriyi \u00e7ekip \u015fablona g\u00f6nderdi\u011finden emin oluyor. Mevcut kod yap\u0131s\u0131n\u0131 inceleyerek, do\u011fru etiketi (<label><\/code>) ve alan\u0131 (<input type="email"><\/code>) ekliyor.\n <\/p>\n
\n Ay\u015fe, yerel sunucusunda blogu \u00e7al\u0131\u015ft\u0131r\u0131yor ve kendi profilini kontrol ediyor. E-posta adresinin do\u011fru bir \u015fekilde g\u00f6r\u00fcnd\u00fc\u011f\u00fcnden emin oluyor. Projede mevcut olan birim testleri varsa (php artisan test<\/code>), bunlar\u0131 da \u00e7al\u0131\u015ft\u0131rarak kendi de\u011fi\u015fikli\u011finin herhangi bir \u015feyi bozmad\u0131\u011f\u0131n\u0131 do\u011fruluyor.\n <\/p>\nfeat: Kullan\u0131c\u0131 profiline e-posta alan\u0131 eklendi<\/code>.\n <\/p>\n
\n Ay\u015fe, BlogEngine deposunu kendi GitHub hesab\u0131nda fork’luyor. Kendi yerel deposundaki de\u011fi\u015fiklikleri bu fork’lanm\u0131\u015f uzak depoya (git push origin main<\/code>) g\u00f6nderiyor. Ard\u0131ndan, GitHub aray\u00fcz\u00fcnden BlogEngine’in ana deposuna bir Pull Request (PR) olu\u015fturuyor. PR a\u00e7\u0131klamas\u0131nda, hangi sorunu \u00e7\u00f6zd\u00fc\u011f\u00fcn\u00fc (\u00f6rne\u011fin, “Fixes #123”) ve yapt\u0131\u011f\u0131 de\u011fi\u015fikli\u011fi detayl\u0131 bir \u015fekilde anlat\u0131yor.\n <\/p>\nDaha Derinlere: Hangi T\u00fcr Sorunlar OSS Buddy \u0130\u00e7in \u0130dealdir?<\/h2>\n
1. Dok\u00fcmantasyon Eksiklikleri ve Hatalar\u0131<\/h3>\n
\n
2. K\u00fc\u00e7\u00fck Hata Ay\u0131klamalar (Bug Fixes)<\/h3>\n
\n
if<\/code> kontrol\u00fc veya k\u00fc\u00e7\u00fck bir mant\u0131ksal d\u00fczeltme gerektiren hatalar.<\/li>\n<\/ul>\n3. K\u00fc\u00e7\u00fck \u00d6zellik Ekleme veya \u0130yile\u015ftirmeler<\/h3>\n
\n
4. Test Ekleme veya \u0130yile\u015ftirme<\/h3>\n
\n
CONTRIBUTING.md<\/code> dosyas\u0131n\u0131 dikkatlice okumak \u00f6nemlidir. Bu dosya, katk\u0131da bulunma s\u00fcreci, kodlama standartlar\u0131 ve kabul edilen sorun t\u00fcrleri hakk\u0131nda detayl\u0131 bilgi i\u00e7erir.\n <\/p>\nOSS Buddy’yi Yerel Ekosistemde Kullanmak<\/h2>\n
\n
Sonu\u00e7<\/h2>\n
S\u0131k\u00e7a Sorulan Sorular (SSS)<\/h3>\n
\n
\n Cevap:<\/strong> Temel olarak yeni ba\u015flayanlara odaklanm\u0131\u015f olsa da, deneyimli geli\u015ftiriciler de zaman zaman k\u00fc\u00e7\u00fck ve h\u0131zl\u0131 katk\u0131lar yapmak isteyebilirler. OSS Buddy felsefesi, genel olarak “k\u00fc\u00e7\u00fck ama de\u011ferli” katk\u0131lar\u0131 te\u015fvik eder.\n <\/li>\n
\n Cevap:<\/strong> GitHub, GitLab, Bitbucket gibi t\u00fcm pop\u00fcler kod bar\u0131nd\u0131rma platformlar\u0131nda, “issues” veya “merge requests” b\u00f6l\u00fcmlerini inceleyerek bu t\u00fcr g\u00f6revleri bulabilirsiniz.\n <\/li>\n
\n Cevap:<\/strong> E\u011fer bir sorun zaten \u00e7\u00f6z\u00fcl\u00fcyorsa veya \u00fczerinde \u00e7al\u0131\u015f\u0131l\u0131yorsa, ba\u015fka bir “good first issue” veya benzeri bir g\u00f6rev arayabilirsiniz. Alternatif olarak, o sorunla ilgili bir iyile\u015ftirme veya farkl\u0131 bir bak\u0131\u015f a\u00e7\u0131s\u0131 sunabilecek bir katk\u0131n\u0131z varsa, bunu tart\u0131\u015fma b\u00f6l\u00fcm\u00fcnde belirtebilirsiniz.\n <\/li>\n
\n Cevap:<\/strong> \u0130lk PR’\u0131n\u0131z\u0131n reddedilmesi veya geri bildirim almas\u0131 olduk\u00e7a normaldir. \u00d6nemli olan, geri bildirimleri dikkate almak, neden reddedildi\u011fini anlamak ve gerekli d\u00fczeltmeleri yaparak yeniden denemektir. Bu, \u00f6\u011frenme s\u00fcrecinin bir par\u00e7as\u0131d\u0131r.\n <\/li>\n
\n Cevap:<\/strong> Kendi projeniz varsa, “issues” b\u00f6l\u00fcm\u00fcne “good first issue”, “beginner friendly” gibi etiketler ekleyerek yeni katk\u0131da bulunanlar\u0131 te\u015fvik edebilirsiniz. E\u011fer mevcut bir yerel a\u00e7\u0131k kaynak projesine katk\u0131da bulunmak istiyorsan\u0131z, projenin “issues” listesini tarayarak yukar\u0131da bahsedilen kriterlere uyan g\u00f6revleri bulabilirsiniz.\n <\/li>\n<\/ul>\n