Fatih Acet

Fatih Acet

Co-f & CTO at Superpeer

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

My Afternoon Coffee Routine (with Rocket Appartamento & Eureka Specialita)

Merhabalar Is guc yogunlugundan kanala icerik gonderemiyorum, bildiginiz uzere Superpeer asiri yogun Bazi gunler gercekten YouTube'a video ...

Superpeer'in kuruluş hikayesi

Superpeer'i kuralı neredeyse 1 yıl oldu. Bu süreçte iki yatırım aldık ve büyük bir ekip haline geldik. Aşağıdaki sorular çeşitli mecralardan sürekli soruluyor ve ben ...

Superpeer'in Serverless Yapisi, Cloud Functions/Cloud Run ve GCP/AWS karsilastirmasi

Merhabalar Superpeer, 2020 yilininda basinda kurdugum ve Subat ayinda 2.8 milyon dolar yatirim alan yeni girisimim. Superpeer'i Google Cloud Platform ...

JavaScript Egitimi #03: Statements

03:40 If statement 05:40 For statement 14:54 While statement 19:37 Do while statement 23:11 Object 26:55 Array 45:08 forEach 50:50 for in.

JavaScript Egitimi #02

Frontend Calisma Grubuyla beraber JavaScript egitim serisine basladik. Serinin devami gelmeye devam edecek. Bu videodaki sesle ilgili problem icin kusura ...

JavaScript Egitimi #01: JavaScript'e Giris

Frontend Calisma Grubuyla beraber JavaScript egitim serisine basladik. Bu ilk videoda JS'e giris yaptik ve yaptigimiz oturumu kayit altina aldik. Serinin devami ...

Acet Yollarda EP01: Gokay Gurcan

Selamlar Bu videoda Almere'den Amsterdam'a giderken Gokay Gurcan'la arabada yaptigimiz muhabbeti kaydettik. Spontane gerceklestirdimiz bu kayit bence ...

Hollanda'ya taşınmak, ev bulmak ve yaşam | Yurtdışında Yaşam Medium

Merhabalar arkadaslar Bu videoda Didem'le beraber Melissa Gurcan'in Yurtdisinda Yasam Medium'u icin Hollanda'da is bulmak, vize surecleri, ev kiralamak, ...

VLOG:🌷Keukenhof - Hollanda Lale Bahcesi

Merhaba arkadaslar Keukenhof Hollanda'nin Lisse sehrinde bulunan ve Mart ayinda acilip Mayis ayinda kapanan cok ozel bir lale bahcesi. Bu sene ilk defa ...

Vue Router: Alias ve Nested Route ornegi

Selam arkadaslar kodilan.com icin kodilan.com/ilan-ara?type=3 seklinde gozuken URL'leri kodilan.com/ilan-ara/stajyer seklinde de calismasi icin gereken ...

Google Tag Manager nasil kullanilir?

Bu videoda Google Tag Manager ile sayfada olan olaylarin nasil track edilecegini anlattim. Google Analytics uzerine eklenen Google Tag Manager sayesinde ...

Proje Kod İncelemesi: kodilan.com | Vue, Vuex, Vue Router

Selamlar arkadaslar Uzun bir aradan sonra yeni bir video ile tekrar YouTube'a donus yapmak istedim. Bu arada halimi hatrimi soran, neden sessiz kaldigimi ...

Tatil 2018 Drone Footage

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

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

Üniversite sınav sonuçları yakında açıklanıyor, tercih dönemi yaklaştı. Bilgem Çakır, Selman Kahya ve Levent Şapçı ile bir araya geldik ve tercih yapacak ...

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

Merhaba arkadaşlar Bu videoda Better Touch Tool kullanarak Mac OS pencere yönetimini kolaylaştırmaktan bahsedeceğim. Çalışırken hayatımı gerçekten ...

Sunum: GitLab ve GitLab Frontend'i

Herkese merhaba arkadaslar Software Craftsmanship Turkey'de yaptigim GitLab ve GitLab Frontend'ini anlattigim sunumu tekrar anlatarak sizlere ...

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

Bu videoda daha onceden olusturdugumuz bir Vue SPA'i GitLab CI kullanarak DigitalOcean'daki bir droplet'a ve Surge.sh servisine deploy etmeyi anlattim.

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

Selam arkadaşlar Bu videoda, kullandığımız bir child component'in DOM element'ine ait bir event'i dinlemek için kullandığımız Vue .native event modifier'dan ...

Bolum 3: GitLab Chrome Extension'i yapalim

Selamlar Ilk iki bolumunu beraber gelistirdigimiz Chrome eklentisine bu bolumde de devam edecegiz. Planimiz, proje bazli bir dashboard gostermek ve token ...

Bolum 2: GitLab Chrome Extension'i yapalim

Selamlar Birinci bolumune asagidaki linkten ulasabileceginiz GitLab Chrome extension'i yapmaya devam ediyoruz. Bu bolumde projeye gelen bir MR'i review ...

Bolum 1: GitLab Chrome Extension'i yapalim

Selamlar Aniden bir canli yayina basladim fakat aklimda olan bir fikri bos vaktim varken kodlamak istedim. Projeye yeni baslayacagim icin bir canli yayin ...

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

Bu videoda en cok merak edilen konulardan biri olan Refactor ve Rewrite konusunu ele aldim. Kodu iyilestirme ya da bastan yazma soz konusu oldugunda ...

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?

Vuex mini serisinin son videosunda bir uygulamayi Vuex kullanmadan nasil gelistirebiliriz hakkinda bir kac ipucu ve fikirden bahsettim.

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

Bu videoda 15 dk icinde size Vuex konseptlerini kolay bir ornekle anlatmaya calistim. Bir onceki videoda Vuex'i neden kullandigimizi anlatmistim bu 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?

Selamlar arkadaslar Bu video ile kanaldaki teknik videolara donus yaptim. Kanalimda daha once Vuex anlattim ve Vuex'le uygulama yaptik ama bu seri biraz ...

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

Yeni videolarda gorusmek uzere.

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

23 Ekim 2017 saat 22:00'de gerceklestirecegimiz Blockchain ve Bitcoin canli yayininda Turkiye'de Bitcoin konusunda uzman isim olan Alp Isik ve Webrazzi'de ...

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 ...