Yapay zekadan makale özeti
- Kısa
- Ayrıntılı
- Bu video, Write the Dogs İstanbul'un ikinci buluşmasında Trendyol'dan Barış Çeviz'in sunduğu bir teknik sunumudur. Barış Çeviz, Trendyol'da check-out ekibinde yazılım geliştiricisi olarak çalışmaktadır.
- Sunum, yazılım geliştirme sürecinde belgelendirme ve dokümantasyonun önemini ele almaktadır. Trendyol'da kullanılan belgelendirme platformları (developer.trendyol.com, wiki.trendyol.com, Swagger) ve araçlar (Lucidchart, Git, Postman) detaylı olarak anlatılmaktadır. Ayrıca iş zekası belgelerinin hazırlanması, flow chart'ların kullanımı ve API standartlarının önemi vurgulanmaktadır.
- Sunum, e-ticaret dünyasında belgelendirmenin önemini vurgulayarak yeni başlayanlar için API'ların nasıl belgelendirildiğini göstermekte ve belgelendirme süreçlerinin sürekli güncellenmesi gerektiğini belirtmektedir. Video, bir soru-cevap bölümüyle sona ermektedir.
- 00:14Konuşmacının Tanıtımı
- Barış Çeviz, Trendyol.com'da check-out ekibinde yazılım geliştiricisi olarak çalışıyor.
- Microsoft'un studio partner programında yer alıyor ve Microsoft'un desteğini alarak teknolojiyi anlatıyor.
- Öğrenci olarak Yıldız Teknik Üniversitesi'nde eğitim görmektedir.
- 02:20Dokümantasyonun Önemi
- Dokümantasyon, bir kişinin işi yapabildiği gibi, onun yerine gelen kişiye bilgi aktarmanın bir yoludur.
- Dokümantasyon sadece yazı değil, video, resim gibi farklı formatlarda da olabilir.
- İlk belgelendirmeler, mağaralara resim çizen insanlar tarafından yapılmıştır.
- 03:49Trendyol'da Dokümantasyon
- Trendyol teknoloji ekibinde yaklaşık 250 kişi bulunuyor ve bunların 150'ü geliştirici ve test mühendisleridir.
- Trendyol'da "developer.trendyol.com" adlı bir web sitesi bulunuyor ve burada web uygulamaları için standartlar ve kurallar belgelenmiştir.
- API geliştirme sürecinde, log takibi, yetkilendirme gibi işlemler için standartlar mevcuttur.
- 06:02Dokümantasyon Sistemleri
- Trendyol'da "wiki.trendyol.com" adlı bir wiki uygulaması bulunuyor.
- Wiki'de ödeme sistemlerinin aksiyonları gibi detaylı bilgiler tutulmaktadır.
- Swagger teknolojisi kullanılarak API'ların endpointleri ve parametreleri belgelenmektedir.
- 08:35Yazılım Geliştirme Sürecinde Dokümantasyon
- Projelerde yeni özellikler geliştirildiğinde, iş zekası (lojik) proje yöneticiler tarafından genellikle wiki sayfalarında belgelendirilir.
- Geliştiriciler iş zekasını teknik anlamda detaylandırarak belgelendirmeye başlarlar, böylece tüm süreci dökümantasyon içerisinde bulabilirler.
- Dokümantasyon yazı şeklinde veya flow chart (akış diyagramı) şeklinde aktarılabilir, şirket olarak Lucidchart gibi araçlar kullanılır.
- 09:50Dokümantasyon Yöntemleri ve Önemi
- Flow chart'ların temel amacı bir sürecin nasıl çalıştığını şematik olarak göstermektir.
- Dokümantasyon ekip içinde belgelendirme yapmak için özel olarak yapılır ve Trendyol.com Tech olarak checkout API gibi tasarımlar için belgelendirme yapılır.
- Geliştirilen API'lerin tüm platformlar tarafından kullanılacağından (web, mobil ekipler dahil) belgelendirme önemlidir.
- 11:05Standartlar ve Belgelendirme
- Standartlar belirli bir noktaya kadar mevcuttur, geri kalan süreçler kullanıcının ihtiyaçlarına göre değişir.
- Hatalı istekler (örneğin çok uzun isim veya şifre göndermek) sistemde sorun yaratabilir.
- Geliştirme sürecinde standartlara uyarak ilerlemek önemlidir, aksi takdirde hata alma süreci veya yanlış bilgi gösterme gibi sorunlar yaşanabilir.
- 14:15Geliştirme Süreci ve Araçlar
- Projelerde continue integration ve continue development için kullanılan araçlardan alınan puanlar ve skorlar gözlemlenir.
- Geliştirme ortamında versiyon takibi için Git depoları kullanılır.
- Trendyol.com'un referanslı belgesindeki standartlara göre geliştirme yapılır.
- 15:24Performans İzleme ve Dokümantasyon Bakımı
- Uygulamaların performansını izlemek için ücretli bir araç kullanılır, bu araç yanıt süresini analiz eder.
- Dokümantasyon sürekli güncellenmesi ve bakımı gerektirir, yeni özellikler eklendiğinde anında güncellenebilmesi gerekir.
- Kaliteli belgelendirme geliştirme sürecinde zaman kazandırır ve yurt dışından gelen insanlar da kolayca çalışabilir.