Aşırı kötü dokümantasyondan bir şeyler anlamak

SideWinder dedi:

Aslında bol bol örneklere bakarak çözmek, böyle durumlarda işe yarayabiliyor. Mesela ben de, Ethereum, React Native gibi projelerde çalışırken sorunlar çekmiştim. Dökümantasyonları var, ama karman çorman.

Aynı şekilde, bir devre kartı, mikroişlemci veya basit bir transistör kullanmam gerektiğinde bile, dökümantasyonlar karman çorman olabiliyor.

Kendimce bulduğum yöntem, bol bol örneklere bakmak oluyordu. Bu, hem baktığım şeyi kavramama hem de nasıl kullanıldığını anlamama yardımcı oluyordu.

Tabii, örnek her zaman işe yaramayabiliyor.

Genişletmek için tıkla...

TerabyteForever dedi:

Selamlar herkese.

Dokümantasyonu aşırı kötü olan bir kütüphaneyi nasıl çözebiliriz?

wxWidgets'ı mesela dokümantasyonundan anladım ve iyi bir seviyeye geldiğimi düşünüyorum, aşırı güzel bir dokümantasyonu var. Ama çoğu API, framework veya kütüphanenin dokümantasyonu ya hiç yok, ya da çok zayıf. Hal böyle olunca da anlayamıyorum.

Yardımlarınızı bekliyorum. Özellikle @bitwise ve @Vavien. hocalarım bakabilirse çok sevinirim.

Genişletmek için tıkla...

bitwise dedi:

O kutuphaneyi kullanan acik kaynakli proje varsa nasil kullanmislar ona bakmak bir yontem. Hangi parametrelerle cagirmislar, ne yaptirmislar.

Kutuphaneyi acip CLI koduna bakmak bir yontem. Hangi parametrelere ihtiyac duyuyor. Eger command line calismasi planlanan bir seyse bu kismin kodunu ayirirlar, bakip kisa zamanda ne - ne yapiyor gorebilirsin hic dokumantasyon olmasa da.

Bunun disinda da kendi kendine deneme yanilma yaparak bir seylere varmaya calisabilirsin ama cok zaman alir bu. Sahsen kutuphaneyi lokal olarak build edebiliyorsan acip kendin kodunu kurcalayarak ogren, ya da fork edip dokumantasyon yaz, community'e bir katkin olur : )

Bu dediklerimin hepsi zaman alan seyler, kotu dokumante edilmis kutuphanede baska seyler de kotu yapilmistir cok buyuk ihtimalle.

Genişletmek için tıkla...