Atlas Framework Dokümantasyon ve Geri Bildirim Merkezi

[XFSkins]

Atlas dokümantasyon ve geri bildirim merkezi​

Bu forum alanı, XFSkins Atlas Framework için yaşayan bir dokümantasyon ve geri bildirim merkezi olarak kullanılacak.

Genel tanıtım konusunda Atlas'a neden geçtiğimizi ve yeni framework yaklaşımımızı anlattık. Bu konu ise bu forumun nasıl kullanılacağını, property gruplarının nasıl belgeleneceğini ve geri bildirimlerin nasıl toplanacağını açıklamak için açıldı.

Bu forumda neler olacak?​

Burada Atlas Framework ile ilgili dokümantasyon başlıklarını, kullanım notlarını, property açıklamalarını ve geliştirme geri bildirimlerini düzenli şekilde toplayacağız.

Bu alan özellikle şunlar için kullanılacak:

• Atlas property gruplarının tek tek açıklanması
• Her property'nin ne işe yaradığının anlatılması
• Hangi ayarın forumun hangi alanını etkilediğinin örneklenmesi
• Child tema geliştirirken dikkat edilmesi gereken noktaların paylaşılması
• Çalışmayan veya kafa karıştıran property alanlarının raporlanması
• Yeni property veya yeni grup önerilerinin tartışılması
• Atlas Framework yol haritasının takip edilmesi

Property grupları için ayrı konular​

Her Atlas property grubu için ayrı bir dokümantasyon konusu açacağız. Böylece sorular ve geri bildirimler tek bir büyük başlıkta karışmak yerine ilgili grubun altında toplanacak.

Mevcut Atlas property grupları şunlardır:

• Atlas: Global settings
• Atlas: Header and navigation
• Atlas: Breadcrumb
• Atlas: Hero
• Atlas: Guest block
• Atlas: Forum and node list
• Atlas: Sidebar
• Atlas: Discussion list
• Atlas: Messages
• Atlas: Extra Footer

Bir property grubu konusunda neler yer alacak?​

Her property grubu konusu mümkün olduğunca aynı düzenle hazırlanacak.

Planlanan içerik yapısı:

• Grubun amacı
• Hangi alanları etkilediği
• Property listesinin açıklaması
• Varsayılan kullanım önerisi
• Child tema üretirken dikkat edilmesi gerekenler
• Light / dark mod davranışı
• Mobil ve masaüstü etkileri
• Sık karşılaşılan sorunlar
• Önerilen yeni property fikirleri

Soru veya sorun bildirirken nasıl yazalım?​

Bir property ile ilgili soru, sorun veya öneri paylaşırken mümkünse şu bilgileri ekleyin:

• İlgili property grubu
• İlgili property adı
• Beklenen davranış
• Gerçekte oluşan davranış
• Test edilen tema veya child tema
• Light / dark mod bilgisi
• Masaüstü veya mobil görünüm bilgisi
• Varsa ekran görüntüsü

Bu şekilde sorunları daha hızlı tespit edebilir, property açıklamalarını daha iyi hale getirebilir ve Atlas'ı yeni XFSkins temaları için daha güçlü bir temel haline getirebiliriz.

Öneriler nasıl değerlendirilecek?​

Yeni property veya grup önerilerinde temel ölçütümüz şu olacak:

• Bu ayar birden fazla child temada gerçekten işe yarıyor mu?
• Admin panelden yönetilmesi LESS dosyasına müdahaleden daha doğru mu?
• XenForo native yapısını bozmadan uygulanabiliyor mu?
• Atlas'ın bakımını kolaylaştırıyor mu?
• Child temalara gerçek tasarım esnekliği kazandırıyor mu?

Bu kriterleri karşılayan öneriler Atlas Framework'e eklenmek üzere değerlendirilecek.