1. Rehber
Bir projeyi nasıl yapabileceğini anlatır. Benim yaptığım anlamına gelmez.
Bitirdiğim ve başkasına anlatabileceğim bir projem olduğunda buraya koyacağım. Bir projenin buraya girmesi için neye ihtiyacım olduğunu aşağıda yazdım.
Bir projeyi nasıl yapabileceğini anlatır. Benim yaptığım anlamına gelmez.
Bir konuyu göstermek için hazırlanmış örnek kod, devre ya da tasarım.
Denemeleri, hataları ve sonrasında yapılan değişiklikleri tarihiyle gösterir.
Fikri kimin bulduğu, neyi benim yaptığım, testler, kaynaklar ve yayın izni belli.
| Konu | Yazacağım şey | Yazmayacağım şey |
|---|---|---|
| Problem | Neye ihtiyaç vardı ve kim kullanacaktı — kendi cümlemle | Başkasının özel durumu, izinsiz kişisel bilgi |
| Çözüm | Şema, algoritma, malzeme ve sürüm | Hazır bir projeyi kendim yapmışım gibi göstermek |
| Katkı | Hangi parçayı kimin yaptığı | Birlikte çalıştığım kişinin adı ve fotoğrafı, izni olmadan |
| Test | Ne bekledim, ne oldu, nerede hata çıktı | Yalnız işe yarayan denemeyi seçmek |
| Kaynak | Kullandığım kod, görsel, veri ve lisanslar | Nereden geldiği belli olmayan kopya içerik |
| Güvenlik | Elektrik, alet, veri ve yetişkin desteği | Tehlikeli bir şeyi tekrarlamaya özendiren ayrıntı |
| Yayın izni | Fotoğraf ve kişisel bilgi için alınan onay | Belge numarası, konum, özel iletişim bilgisi |
Bir şeyin bir kere çalışması, bittiği anlamına gelmiyor. Sayfayı okuyan biri ne yaptığımı anlayabilmeli, aynı testi kendi tekrarlayabilmeli ve kullandığım kaynakları bulabilmeli. Bir projeyi buraya koymadan önce şunları yapacağım:
Sensör verisi, eşik değeri, yanlış sayımlar ve mahremiyet üzerine.
Rehberi aç →Zaman ölçümü, gecikme, tekrar ve adil karşılaştırma üzerine.
Rehberi aç →Veriyi klavyeyle kullanılabilir ve renk dışı işaretlerle sunmak üzerine.
Rehberi aç →Bir projeyi bitirip başkasına anlatabilecek hâle geldiğimde buraya ekleyeceğim. Yalnız sonucu değil; problemi, nasıl yaptığımı, nerede takıldığımı, kullandığım kaynakları, güvenlik tarafını ve gerçekten benim yaptığım kısmı da yazacağım.
İşe yaramayan denemeleri de yazacağım. Sonradan bir projeyi kaldırır ya da değiştirirsem sessizce yapmam, nedenini de yazarım.