Kaynak kodu özel olan bir ürün nasıl anlatılır?.

Her proje açık kaynak olmak zorunda değil. Ama bir ürünün depoyu açmadan tanıtılması, yalnızca adını ve teknoloji listesini koymaktan fazlasını gerektiriyor.

Kodu değil, kararları göster#

İyi bir ürün anlatımında dört şey arıyorum:

• Problem: Bu ürün hangi gerçek ihtiyaca cevap veriyor?
• Yaklaşım: Problemi çözmek için hangi mimari veya tasarım kararlarını aldım?
• Ortaya çıkan iş: Kullanıcı bugün ne yapabiliyor?
• Sınırlar: Hangi parçalar geliştiriliyor, hangi bilgiler özel kalmalı?

Bir ekran görüntüsü faydalı olabilir; ancak gerçek veriler, erişim adresleri ve uygulama sırları temizlenmeden kullanılmamalı.

Ne paylaşılmamalı?#

Gizli API anahtarları, üretim ortamı adresleri, müşteri verileri, gerçek kullanıcı bilgileri ve istismarı kolaylaştırabilecek hassas iç detaylar portföye taşınmamalı.

Bu yüzden burada bazı projelerimin kaynak kodu bağlantısı yok. Ama her birinin problemi ve çözüm tasarımı okunabilir durumda.