Teknik Yazarlık Web Sitesi Tasarımı

Quartz Teknik Yazarlık Web Sitesi Tasarımı

Quartz, taslaktan metne, incelemeye ve yayına klavyeden ayrılmadan ilerlemek isteyen teknik yazarlar için bir çalışma alanı olarak sunulur. Sayfa, bağlı bir canlı ortam hizmetinin kanıtı değil, bir konsept web sitesidir; bu yüzden en güçlü katkısı editoryal çerçevedir: özelleşmiş bir araca, yeteneklerini sıralamadan önce bir bakış açısı kazandırır.

Açılış cümlesi, büyük ve sola hizalı bir Instrument Serif başlığında yer alır; “docs nobody read” ifadesi italik vurgulanır. 16ch azami genişlik uzun önermeyi kompakt bir sütuna dönüştürürken destekleyici paragraf daha geniş, 52ch'lik bir satır uzunluğu kullanır. Sıcak kırık beyaz zeminde koyu renkli Request access düğmesi, daha sönük Read the manual eylemi ve basılı bir kısayol rozetiyle karşıtlık oluşturur. Bu, yazı önermesini öne çıkarır; ancak bu kontroller duyurulan çalışma alanı görevlerini yerine getirmez.

Tasarımın Desteklediği Görevler

Sayfa birbiriyle ilişkili birkaç web sitesi görevine hitap eder, ancak hepsini Quartz önermesine bağlı tutar. Ziyaretçi ürünün kimler için olduğunu, tasarlanan iş akışının nasıl sıralandığını, neye dönüşmeyi reddettiğini ve planların hedef kitleye göre nasıl ayrıştığını anlayabilir. Bu görevler, özellik yüklü bir girişle değil, kısa etiketler ve tekrarlanan karşıtlıklarla iletilir.

Sayfa Yazımdan Konumlandırmaya Doğru İlerler

Düzen, ürün hikâyesiyle aynı sırayı izler. Büyük bir hero sesi belirler, ardından sayfa inceleme, dışa aktarma, geçmiş ve entegrasyonlara geçmeden önce editörü tanıtır. Sonra karşıtlık bölümü Quartz'ın ne olmadığını söyler; fiyatlandırma bölümü de editoryal duruşu hedef kitleye özel üç teklife çevirir. Bu sıra sayfayı bir katalogdan çok bir savunma gibi okutur.

1. Editörle Başlayın

   İlk numaralı bölüm “01 / OUTLINE” olup başlığı “An outline that doubles as a typewriter.” şeklindedir. Metni, başlıkların sürüklenmesinden, odak modundan ve sayfanın geri kalanının soluklaştırılmasından söz eder. Bu ayrıntılar yapıyı ve konsantrasyonu birbirine bağlar; ancak doğrulanmış çalışma zamanı davranışı değil, önerilen etkileşim davranışı olarak kalır.

2. Ekip Bağlamına Genişleyin

   Sonraki bölümler satır içi inceleme, Markdown dışa aktarma, revizyon geçmişi ve entegrasyonları tanıtır. Etiketler her fikri kompakt tutarken açıklamalar somut ilişkiler ekler: yorumlar bir satıra bağlıdır, bir belge aynı .md yapısını okuyup yazan bir şey olarak anlatılır ve iş kaydı kimlikleri yan panelle ilişkili gösterilir. Her ekleme hayal edilen çalışma alanını genişletir, ancak gerçek bir uygulamanın kanıtlaması gereken ürün iddialarının sayısını da artırır.

3. Ticari Bir Seçimle Kapatın

   Fiyatlandırma bandı, aylık $9'lık Solo'yu, koltuk başına aylık $22'lik Studio'yu ve “Talk / to us” olarak sunulan Press'i karşılaştırır. Farklı faturalama birimleri ve hedef kitle etiketleri tek bir yazarı, bir dokümantasyon ekibini ve bir yayıncıyı birbirinden ayırır. Solo ve Press dörder özellik listeler; Studio beş özellik listeler ve öneri rozetini alır. Press, yalnızca daha uzun bir liste sunmak yerine konuyu SSO, kendi sunucusunda barındırma, dışa aktarma işlem hatları ve desteğe çevirir. Tüm fiyatlar ve yetenekler örnek konumlandırmadır.

Görünen Tasarım ve Yetenek Sınırları

Quartz bir tanıtım konseptidir; uygulanmış bir yazı çalışma alanı değildir. Tek betiği bölümleri IntersectionObserver ile görünür kılar; düğmeleri, gösterilen kısayolları, düzenlemeyi, incelemeleri, dışa aktarmaları veya hesap oluşturmayı işlemez. Yerel bağlantılar Surfaces, What It Isn't ve Plans bölümlerine ulaşır; Changelog için eşleşen bir bölüm yoktur ve alt bilgi bağlantıları yer tutucudur. Bu nedenle sayfa çalışan entegrasyonları, şifreli senkronizasyonu, yayınlamayı veya gerçek fiyat tekliflerini değil, görsel konumlandırmayı gösterir. Bu hizmetler ayrı bir uygulama ve test gerektirir.

Kaynak Atfı

OpenDesign bu örneği Community kütüphanesinde dağıtır. Kaynak dokümantasyon, editoryal minimalizm ve mekânsal ritim rehberliği için Taste Skill by Leonxlnx'i belirtir: https://github.com/Leonxlnx/taste-skill. Bu bir dağıtım atfıdır; OpenDesign'ın bağımsız özgün yazarlığı iddiası değildir. Pakete dahil manifest MIT beyan eder; gösterilen her varlık için ayrı haklar oluşturmaz.