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

Bolum 4: Hollanda kamp yeri gezelim! (Camping de Ruimte)

Merhaba arkadaslar Hollanda'da kaldigimiz kamp yerini gezip gostermek istedim sizlere. Gorusmek uzere.

Bolum 3: Karavan turu (Adria Altea 552PK ic mekan)

Merhaba arkadaslar Bu videoda karavanimizin icini ve disina taktigimiz cadiri anlattim. Umarim begenirsiniz. Gorusmek uzere!

Bolum 2: Karavan yerine yerlesiyoruz

Merhaba arkadaslar, Hollanda kamp yeri acisindan cok secenege sahip olan bir ulke ama bu sene buradaki 4. kamp yerimiz olan Camping de Ruimte'ye geldik ...

Bolum 1: Yeni Karavanimizi Teslim Aliyoruz

Merhaba arkadaslar, Gecen sene sahip oldugumuz Caravelair Antares 400 karavani satip Adria Altea 552PK karavan aldik. Onceki karavanimiz 590cm'yken ...

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

Superpeer Test LiveStream

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?

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