(Öneri) Güvendekal altyapısını değiştirme

[islemci]

Bence şu anda kullanılan dokümantasyon altyapısı yerine nextra gibi nextjs tabanlı ve göze daha hoş gelen bir altyapı kullanılabilir. Ne düşünüyorsunuz? 🤔

[GokturkTalha]

Genel olarak güzel duruyor ama ne kadar gerek var tartışılır. Şuan Docsify üzerinde çalıştırdığımız farklı bir sürü plugin ve benim yazdığım js scriptleri & css kodları var. Bunları yeni altyapıya taşımak çok zahmetli olabilir, docsify pluginlerini hiç taşıyamayız zaten.

[islemci]

Nasıl pluginler var hocam?

[GokturkTalha]

Nasıl pluginler var hocam?

Arama yeri
Github'da düzenleme (dökümanı düzenle)
Footer kısmı

daha vardır ama hatırlamıyorum. Bence önceliğimiz dökümanları tamamlamak olmalı, altyapı değiştirilebilir tabii ancak önceliğimiz bu mu olmalı bilmiyorum.

[odest]

Bence şu anda kullanılan dokümantasyon altyapısı yerine nextra gibi nextjs tabanlı ve göze daha hoş gelen bir altyapı kullanılabilir. Ne düşünüyorsunuz? 🤔

Güzel duruyor aynn, fumadocs da kullanılabilir.
Örnek olarak hızlıca şöyle bişi yaptım:

Daha güzel ve professional duruyor ancak @GokturkTalha nın da dediği gibi, buna zaman ayırmanın pek oluru yok gibi.
Önceliği içeriğe vermek daha mantıklı.

Ama bir ekip bununla dev branch inde ilgilenebilir, gerekli taşıma yapılır eğer uygun olursa merge edilir.

[odest]

Şuan Docsify üzerinde çalıştırdığımız farklı bir sürü plugin ve benim yazdığım js scriptleri & css kodları var. Bunları yeni altyapıya taşımak çok zahmetli olabilir, docsify pluginlerini hiç taşıyamayız zaten.

Hocam çok bilgim yok ancak, orada da benzer işleri yapabilecek pluginler vardır. Ayrıca .md yerine .mdx kullanılıyor, katkı yapacak kişiler de buna adapte olmalı.

[GokturkTalha]

@islemci @odest genel olarak bu tarzda pek çok dökümantasyon sistemi var zaten, ben sizin dediklerinizi bilmiyorum ancak Docsify dışında bilinen bazı diğer sistemlere bakmıştım ve Docsify ile yapma kararı almıştım başlangıçta.

Gerçekten daha güzel durduğunu kabul ediyorum hem @islemci 'nin önerdiği hem @odest 'in gösterdiği.

Siteyi ve dosyaları yeni sisteme aktarmak zahmetli olacak,
Örneğin Font Awesome'dan çektiğimiz ikonlar nasıl duracak,
Denildiği gibi .md yerine .mdx kullanıyor ise bunları yeni sisteme geçirebilecek miyiz, zaten benim yazdığım bütün css kodları değiştirmemiz gerekecek büyük ihtimalle en azından yeni temaya uyumlu hale getirmek gerekecek,
Yine sistem değiştiği için şuana kadar az/çok fark etmez katkı yapan herkesin markdown bilgisindeni docsify bilgisine kadar her şeyi yeniden öğrenmesi gerekebilir,
Dosya yolları değişirse bütün resim dosyalarını tekrar oluşturmamız gerekecek,
Ekleme yapmak, biçimlendirme gibi sayfaları en baştan yapacağız,
Şuan kullandığımız sistemde ?> !> gibi farklı alıntı türleri var mesela bunlarda sıkıntı olabilir.

gibi gibi.

Benim önerim değiştireceksek bile dökümantasyonda bulunan bütün sayfaları bitirdikten yada az kaldığında geçmek. Şuan bütün eforumuzu buraya harcamaya gerçekten değer mi? Bunu düşünmek lazım.

[odest]

@GokturkTalha aynen katılıyorum, şuan için geçmek pek mantıklı durmuyor. Zaten yoğun bir dönemde olduğum(uz) için bu extra iş yüküne zaman ayıramayabilirim(iz).

Altyapı değişikliği her zaman bir option olarak kalmalı tabii.

[GokturkTalha]

Altyapı değişikliği her zaman bir option olarak kalmalı tabii.

Bende tamamen bu fikri atalım gibi bir düşüncede değilim, dediğim gibi gerçekten güzel duruyor kabul ediyorum.

Bende şahsen pek iyi bir dönemimde değilim, harekete geçme isteğim sıfır olduğundan gün içinde pek aktif değilim. Ancak proje zaten yavaşta olsa ilerliyor. Şuan sitenin genel görünümü o kadar kötü de değil zaten. Ondan şimdilik olmasada gelecek planlamasına kesinlikle ekleyelim :)