Fatih Acet

Fatih Acet

Frontend Engineer at GitLab.com

twittergitlabgithubenvelope-olinkedinyoutubeinstagramAbone Ol!

Acik kaynak reklamciligi

Acik kaynak projenizi hazirladiniz. Artik sira projenizin reklamini yapmak, daha cok insana ulasip daha fazla star almak ve hatta projenize disardan destek almaya geldi. Bu yazimda, bunu saglayabilmeniz icin projenizi Twitter, Hackernews, ilgili Facebook gruplari gibi sosyal mecralarda paylasmadan hemen once yapilmasi gereken onemli islerden bahsedecegim.


Oncelikle hemen belirtim, “haci senin GitHub’da en fazla star almis repon 10 kusur star almis sen nasil boyle bir yazi yazabiliyorsun” diye dusunenlere “sen benim dedigimi yap, yaptigimi(yapmadigimi) yapma” diyorum. Bu yazida anlatacaklarim acik kaynak projenize katki saglayarak degerini arttiracaktir. Yapilmasi gereken en oncelikli ve en onemli adimlar bu yazinin konusu olacak. Unuttugum, gozden kacirdigim, atladigim yerler olabilir ama tamamen aksini dusunen varsa cikisa bekliyorum :)

  • README insanlarin projenize dair gordugu ilk sey, dolayisiyla guzel bir README bu isin olmazsa olmazi.
  • Ingilizce yazilmis bir README daha genis kitlelere hitap edecektir.
  • README icine projenizi anlatan ufak bir gif eklemek insanlarin yaptiginiz isi anlamasini cok daha kolaylastiracaktir.
  • README icindeki bir baska onemli nokta ise renkli Build badge’leri. Projenizin daha profesyonal olmasini, gozukmesini saglayacaktir. Insanlar bir bakista en son build durumunu, hangi npm versiyonu oldugunu gorecektir.
  • README’nize insanlarin projenizi test edebilecegi bir link koyarsaniz bu da cok etkili olacaktir. GitHub’in gh-pages‘i, GitLab’in pages‘i veya CodePen, JSFiddle bu is icin bicilmis kaftan.
  • Gelistirme ortaminda kolaylik saglamak projenize katki saglamansini cok daha kolaylastiracaktir.
  • Projenizi nasil kullanacaklarina dair detayli bir dokumantasyon yazin. Eger projeniz bir JavaScript library’si ise nasil kullanacaklarini gosteren kisa ve acik ornekler yazin. Eger projeniz diger insanlarin makinesine kurulmasini gereken biseyse bunu en kisa yapacaklari hale getirin. 8-10 adimli bir install sureci olan projelere katki gelmesi daha zor olacaktir. Hem kendiniz icin hem de diger insanlar icin guzel ve kolay bir gelistirme ortami saglayin.
  • Projenize katkida bulunmak isteyen insanlara yol gosterin. GitHub ve GitLab’in issues kismini aktif olarak kullanin. Issue’larinizi orada listeleyin ve projenize katkida bulunmak isteyen insanlarin kolaylikla baslayacagi issue’lari up-for-grabs, for-contributors gibi label’lar kullanarak etiketleyin ki katki saglamak isteyenler bu tarz issue’lari alip direk baslayabilsinler.
  • Kodunuzu temiz ve anlasilir yazmaya ozen gosterin. Kodunuzun icine aciklamalar ekleyerek anlasilir kilin ve insanlarin kodunuzu anlamasini kolaylastirin.
  • Anlasilir, detayli, ornekler ile desteklenmis bir dokumantasyon yazin. GitHub, GitLab Wiki bu is yapilmis araclar. Ne kadar detayli ve basit yazarsaniz, insanlarin katki saglamasi ve alip kullanmasi o kadar kolay olacaktir.
  • Eger varsa ve biliyorsaniz projeniz ile ilgili teknik uyarilari, kisitlamalari belirtin. Ornegin su library’nin su versiyonu ile calismaz, su aletin su surumunu kullanmaniz gerekir, eger soyle bir sikinti ile karsilasirsaniz su sekilde cozebilirsiniz gibisinden.
  • Projenizin aklinizda gidecegi yeri gosteren bir roadmap yapmaniz cok buyuk bir arti olacaktir. Bu sayede diger insanlar sizin gelecekte yapmayi dusundugunuz ozellikler icin Merge Request gonderebilir.
  • Dogru bir lisans secmek ayrica onemli. Bunun icin ChooseaLicense‘i kullanabilirsiniz.

Aklima gelenler simdilik bunlar. Bu noktada bu blog post’un cok yazidan ibaret oldugunu dusundum ve bir ornek gostermek icin GitHub’i actim. Cok yildiz almis bu pratikleri uygulamis bir repo bakarken Adem Ilter ve Fatih Kadir Akin‘in bricklayer‘ina tekrar denk geldim. Soyle bir goz attim ve adamlar gercekten butun best practice’leri uygulamislar ve an itibari ile 2049 star almislar. O yuzden yerli mali bir repo’dan ornekler gosterecegim.

README

Wiki



Comments

Tatil 2018 Drone Footage

Kas ve Kalkan'da yaptigimiz 2018 tatilimizin drone videosu. Drone: DJI Spark.

Hangi üniversite ve bölümü tercih etmeyeliyim?

Email bultenine abone olmak icin http://bit.ly/acet-subs Üniversite sınav sonuçları yakında açıklanıyor, tercih dönemi yaklaştı. Bilgem Çakır, Selman Kahya ve ...

Faydalı İpuçları #4: Mac OS Pencere Yönetimi | Better Touch Tool

Email bultenine abone olmak icin http://bit.ly/acet-subs Merhaba arkadaşlar Bu videoda Better Touch Tool kullanarak Mac OS pencere yönetimini ...

Sunum: GitLab ve GitLab Frontend'i

Email bultenine abone olmak icin http://bit.ly/acet-subs Herkese merhaba arkadaslar Software Craftsmanship Turkey'de yaptigim GitLab ve GitLab ...

Vue JS SPA'lari deploy etmek: GitLab CI DigitalOcean ve Surge.sh

Email bultenine abone olmak icin http://bit.ly/acet-subs Bu videoda daha onceden olusturdugumuz bir Vue SPA'i GitLab CI kullanarak DigitalOcean'daki bir ...

Faydalı İpuçları #3: VueJS .native event modifier nedir?

Email bultenine abone olmak icin http://bit.ly/acet-subs Selam arkadaşlar Bu videoda, kullandığımız bir child component'in DOM element'ine ait bir event'i ...

Bolum 3: GitLab Chrome Extension'i yapalim

Email bultenine abone olmak icin http://bit.ly/acet-subs Selamlar Ilk iki bolumunu beraber gelistirdigimiz Chrome eklentisine bu bolumde de devam edecegiz.

Bolum 2: GitLab Chrome Extension'i yapalim

Email bultenine abone olmak icin http://bit.ly/acet-subs Selamlar Birinci bolumune asagidaki linkten ulasabileceginiz GitLab Chrome extension'i yapmaya ...

Bolum 1: GitLab Chrome Extension'i yapalim

Email bultenine abone olmak icin http://bit.ly/acet-subs Selamlar Aniden bir canli yayina basladim fakat aklimda olan bir fikri bos vaktim varken kodlamak ...

Biraz sohbet edip AmsterdamJS Tshirt Çekilişi yapalım

Email bultenine abone olmak icin http://bit.ly/acet-subs Oncelikle biraz sohbet edip, bir kac soru cevap yaptiktan sonra AmsterdamJS'den size ozel getirdigim ...

VLOG #06: AmsterdamJS'e gidiyorum

AmsterdamJS etkinliginde VueJS Best Practices konulu bir konusma yapacagim. AmsterdamJS Vlog serisinin ilk videosunda Istanbul'dan Amsterdam'da ...

Benden haberler ve Refactor vs Rewrite konusu

Email bultenine abone olmak icin http://bit.ly/acet-subs Bu videoda en cok merak edilen konulardan biri olan Refactor ve Rewrite konusunu ele aldim.

Yazilimcilar Tasarim Bilmeli mi?

Hakan Ertan Yazilimcilar Tasarim Bilmeli mi? video serisinin 2. videosunda benim de yer almami istedi ve ayni soruyu cevaplamam icin mikrofunu bana uzatti.

Gunluk Latte’mi beraber yapalim

Her gun kahvaltidan sonra yaptigim kahvemi ufak bir video yapmak istedim. iPhone'daki iMovie'yle editledim ve oldukca kullanisli bir app olmus :)

Vuex #03/03: Vuex olmadan nasil yapariz?

Email bultenine abone olmak icin http://bit.ly/acet-subs Vuex mini serisinin son videosunda bir uygulamayi Vuex kullanmadan nasil gelistirebiliriz hakkinda bir ...

VLOG #05: Yerinde Inceleme: Amsterdam'a yaz gelmis mi?

Amsterdam'da havalarin duzeldigini ve yaz geldigini soyluyorlardi. Dun Amsterdam'a donduk ve bugun yerinde inceledik. Sonuc: daha tam gelmemis ama niyeti ...

Vuex #02/03: 15 Dakikada Vuex konseptleri

Email bultenine abone olmak icin http://bit.ly/acet-subs Bu videoda 15 dk icinde size Vuex konseptlerini kolay bir ornekle anlatmaya calistim. Bir onceki videoda ...

GitLab Workflow: VSCode extension for GitLab

This is a product demo of the VSCode extension I built for GitLab. Below you can find related links. Repository: ...

VUEX #01/03: Nedir? Neden kullaniyoruz?

Email bultenine abone olmak icin http://bit.ly/acet-subs Selamlar arkadaslar Bu video ile kanaldaki teknik videolara donus yaptim. Kanalimda daha once Vuex ...

Drone nasil ucurulmaz? DJI Spark Crash

Bugun Rembrandt Park'da talihsiz bir drone kazasi yasadim. 19mt yukseklikte ve yaklasik 40mt ilerimdeydi drone ve bu yukseklikten agaci gecer diye ...

Bilgem Cakir ile Canli Yayindayiz

Bilgem Cakir'la yazilim ve oyun gelistirme uzerine guzel bir sohbet yapacagiz. Canli yayin suresince Bilgem Cakir'a sorularinizi sorabilirsiniz.

NYC'den Fatih Arslan ve SF'dan Cihangir Savas'la beraberiz

Bundan yaklasik 2 ay once Fatih Arslan ve Cihangir Savas'la beraber bir yayin yapma fikrini konusuyorduk. Ortak takvim ayarlamanin zorlugundan dolayi 2 ay ...

VLOG #02: Amsterdam'da ev aradigim ikinci gun

16 Kasim 2017'de Amsterdam'a tasiniyoruz. O yuzden, Amsterdam'a ev bakmak amacli 3 gunluk kisa bir gezi yaptim. Amsterdam'daki ilk gunumu VLOG haline ...

VLOG #01: Amsterdam'a ev bakmaya gidiyorum

Kasim 2017'de Amsterdam'a tasinmayi dusunuyoruz. O yuzden, Amsterdam'a ev bakmak amacli 3 gunluk kisa bir gezi yaptim. Amsterdam'daki ilk gunumu ...

Evde Kahve Yapiyoruz: Espresso, AeroPress, V60 ve Chemex

Merhaba arkadaslar Bugun uzun zamandan beri sozunu verdigim kahve videosunu sonunda yayinliyorum. Sonmez Kartal ile beraber ayni gunde size 4 farkli ...

Blockchain ve Bitcoin Canlı Yayını Alp Işık ve Erman Taylan

Alp Isik YouTube: https://www.youtube.com/user/isikalp91 Twitter: https://twitter.com/alppIsik Erman Taylan Twitter: http://twitter.com/etaylan e-Bulten: ...

Uzaktan Çalışmak: SSK, Vergi ve Fatura işleri

http://uzaktancalismak.com Bu videoda uzaktan calismakla ilgili yayinladigim sitede eksik kalan ve en cok merak edilen konulardan olan SSK, vergi ve fatura ...

Faydalı İpuçları #2: Koddaki bir yerin neresi tarafından çağrıldıgını bulmak

Merhabalar Bu videoda console.trace'den bahsettim. Eger ulasmaya calistiginiz yerin neresi tarafindan cagrildigini bilmiyorsaniz bir debugger koyup stack ...

Sahibinden.com'da karsima cikan Nijeryali dolandiricilar

Merhaba arkadaslar Bu videoda Sahibinden.com'da MacBook Pro satarken karsima cikan Nijeryali dolandiricilarin hikayesini anlattim. Ozellikle bu videoyu ...

Uzaktan calisilacak is bulmak

Bu videoda uzaktan calismak isteyenlere is bulma konusunda yardimci olacak konulardan bahsettim. CV ve cover letter'in oneminden, farkli islere ...

Logitech C930e ve Samson Go Mic inceleme

Merhaba arkadaslar Bu videoda sizlere yeni aldigim Logitech C930e kamera ve Samson Go Mic'in bir incelemesini ve Nikon D3200 DSLR, Go Pro Hero ...

Kod Review nedir? Neden yapilir?

Bu videoda sizlerin istegi uzerine kod review konusunu anlattim. Kod review'in ne oldugundan, neden onemli oldugundan ve kod review yapan kisinin nelere ...

MacBook Mevzusu: Neden çok da şey yapmamak lazım?

Bu videoda gerek emaillerde gerekse canli yayinlarda olsun sikca sorulan sorulardan biri olan MacBook konusuna degindim. Sorular genelde, "Neden herkes ...

Faydalı İpuçları #1: DevTools Break on özelliği

Yeni bir video konsepti olan Tips & Tricks playlist'inde sizlere gunluk hayatta kullandigim, isimi kolaylastiran, yillarin deneyimi ile ogrendigim kolayliklari 2-3 dk ...

Yazilim gelistirme uzerine Soru Cevap Yayini - 2

Bu aralar bebek telasindan dolayi yeni videolara pek zaman ayiramiyorum. O yuzden bir, bir bucuk saat arasinda sorulariniza cevap vermeye calistigim bir yayin ...

Ozel saglik sigortasi deneyimimiz

Bebegimiz ozel saglik sigortasi kapsaminda dunyaya geldi. Ayrica kisisel olarak 2 yildan fazla suredir ozel saglik sigortasi kullaniyorduk. Ozellikle hamilelik ...

Frontend Developer kimdir? Neleri bilmelidir?

Bu video sizlere Frontend Developer'in kim oldugunu, sorumluluklarini ve neleri bilmesi gerektigini anlattim. Umarim yararli bir video olmustur. Begendiyseniz ...

Kullandigim ve isime yarayan bazi uygulamalar

Bu video uzaktan calisirken ozellikle mobil datami ve zamanimi verimli kullanmama yardimci olacak bir kac uygulamayi sizle paylasmak istedim.Bu uygulamalari ...

Server Side Rendering Nedir? VueJS ile basit SSR yapalim

Bu videoda Server Side Rendering'in ne olduguna bakip VueJS ile yaptigim basit bir ornegi sizlerle paylastim. Blogumda YouTube'da yayinladigim videolarin ...

Sektorde Ingilizcenin onemi ve Ingilizce ogrenme ipuclari

Bu videoda esim Didem ile yazilim sektorunde Ingilizce'nin onemi ve Ingilizce konusunda kendinizi gelistirmeniz icin ipuclari verdigimiz bir video kaydettik.

Kolay IK Yazilim Kampi: Genclere egitim ve is firsati

Arkadaslar Kolay IK bir egitim kampi duzenliyor. Yaklasik bir bucuk ay surecek bu egitimde HTML, CSS, JS, NodeJS, Laravel, PostgreSQL, MongoDB, Redis, ...

Git nedir? Neden ve nasil kullaniyoruz?

Ne nedir'in ikinci videosunda Git'den bahsettim. Git'in ne oldugundan, neden kullandigimizdan, oneminden, SSH key'lerin ne oldugundan ve nasil ...

Vue JS, Vue Router ve Vuex SPA Bölüm 4

Vue Router, Vuex ve Firebase kullarak gelistirdigim Vue Single Page Application'in dorduncu bolumu. Bir onceki bolumde uygulamanin anasayfasini yapmistik, ...

Terminal nedir? Neden kullaniyoruz?

Ne Nedir playlist'inin ilk videosunda Terminal'in ne olduguna ve gunluk hayatimizda neden ve nelerde kullandigimizi anlattim. Mac OS icinde yuklu gelen ...

GitLab'da 1. yılım bitti. Ne yaptım, ne ögrendim?

Mayis 2016'da calismaya basladigim GitLab'da bir yil gecirdim ve gectigimiz bir yilin ozetini yapmak icin GitLab'e nasil girdim? Ben GitLab'e girdigimde GitLab ...

Vue JS, Vue Router ve Vuex SPA Bölüm 3

Vue Router, Vuex ve Firebase kullarak gelistirdigim Vue Single Page Application'in ucuncu bolumu. Bu bolumde uygulamamizi ayaga kaldirip, anasayfamizi ...

Vue JS, Vue Router ve Vuex SPA Bölüm 2

Vue Router, Vuex ve Firebase kullarak gelistirdigim Vue Single Page Application'in ikinci bolumu. Bu bolumde Vuex ve Vue Router'in temel prensiplerinden ...