NextPDF'in içinde

Spec Spec: ISO 32000-2 ISO 32000-2 Spec Spec: WCAG 2.2 WCAG 2.2 Evidence ¶ Editorial Evidence: Editorial

Bir bakışta

Insider_, NextPDF’in neden bu şekilde davrandığını açıklayan belge bölümüdür. Başvuru, bir metodun ne döndürdüğünü söyler. Insider_ ise bu değeri neden döndürdüğünü ve gerekçeyi hangi standardın veya testin yerinde tuttuğunu söyler.

PDF ve PHP kod tabanlarına zaten hâkim olan kıdemli bir mühendis için yazılmıştır. Bu okuyucu, iç rahatlatan on sayfa yerine dürüst tek bir sayfayı okumayı yeğler.

Bu neden önemli

PDF, köklü ve katı kuralları olan bir biçimdir: tahminlere tolerans göstermez. Bunu sizden gizleyen bir kütüphane, imzalı belge üretim ortamında doğrulamadan geçemediği ve kimsenin nedenini açıklayamadığı ana kadar iyi görünür.

Insider_ ise tam tersi bir duruş benimser. Her sayfa, ileri sürdüğü iddianın kapsamını belirtir, arkasındaki kanıtı adıyla anar ve siz kendiniz keşfetmeden önce kısıtlamalara işaret eder. Amaç sizi etkilemek değildir. Bir incelemede savunabileceğiniz bir karar vermenize yardımcı olmaktır.

Kısaca

• Insider_ sayfaları, API başvurusu değildir; açıklayıcı ve yorum niteliğinde sayfalardır.
• Her sayfa, ilgili standartları ve sayfanın dayandığı kanıt türünü belirten bir rozet satırı içerir.
• Her sayfa aynı on bölümlü düzeni izler; böylece her seferinde düzeni yeniden öğrenmek zorunda kalmadan ihtiyacınız olan bölüme göz atabilirsiniz.
• Burada hiçbir metrik metin içinde yinelenmez; sayılar, ölçümün sahibi olan sayfada bulunur; böylece bir değer metin içinde fark edilmeden eskimez.

NextPDF buna nasıl yaklaşır

Her Insider_ sayfası tek bir konuyu ele alır, kendi başına yeterlidir ve en yararlı bilgiyi sayfanın üst kısmına yakın bir yere koyar. Bu yapı bilinçli bir tercihtir. Bilgi tasarımı yönergelerini izler: ilgili içerik gruplandığında ve hiyerarşi görünür olduğunda okuyucular ihtiyaç duydukları bilgiyi daha hızlı bulur. Ayrıca sayfayı ekran okuyucuyla kullanılabilir tutar, çünkü ekrandaki sıralama, işaretlemedeki sıralamayla aynıdır.

Bir sayfa, aşağıdaki sırayla bağlamdan iddiaya, iddiadan kısıtlamaya doğru ilerler:

1. At a glance What this page is, in two sentences.
2. Why this matters The cost of getting it wrong.
3. The short version The answer, before the detail.
4. How NextPDF approaches it The reasoning and the mechanism.
5. What the evidence says The standard, code, or test — tagged.
6. Practical example A small, runnable shape.
7. Common misconception The trap, named.
8. Limits and boundaries Where the claim stops.

Bir Insider_ sayfasının yukarıdan aşağıya nasıl yapılandırıldığı: okuyucu herhangi bir adımda durabilir ve yine de eksiksiz, savunulabilir bir yanıta sahip olur.

Human-factors note: Human-factors note

Rozet satırı, sabit bölüm sırası ve Insider_ sözcüğünün sonundaki alt çizgideki sıcak vurgu, kendi başına bir süsleme değil, insan faktörleri yönergelerine dayanan tasarım tercihleridir. Vurgu, gürültüye dönüşmeden bölümü belirginleştirir. Hiçbir zaman canlandırma yapmaz; gezinmedeki tek renk sinyalidir ve bir ekran okuyucunun seslendirdiği sözcük yine “Insider”dır. Buradaki anlam hiçbir zaman yalnızca renkle taşınmaz. Ayrıca her rozet bir metin etiketi ve bir rol sözcüğü taşır.

Kanıtlar ne söylüyor

Insider_ sizden kendisine güvenmenizi istemez. Her sayfa bir kanıt düzeyi bildirir ve rozet satırı bunu gösterir:

• Evidence { } Code-backed Evidence: Code-backed — iddia, motorun kendi kaynak kodu veya çalıştırılabilir bir örnek üzerinden denetlenir.
• Evidence § Standard-backed Evidence: Standard-backed — iddia, yayımlanmış bir standardın bir maddesine dayandırılır; başka sözcüklerle ifade edilir ve atıf verilir, lisanslı bir belgeden asla alıntı yapılmaz.
• Evidence ✓ Test-backed Evidence: Test-backed — iddia, test paketindeki bir testle desteklenir.
• Evidence ◇ Design principle Evidence: Design principle — sayfa, ölçülmek yerine gerekçelendirilen bilinçli bir tasarım kararını belirtir.

Bir sayfa bunları birlikte kullandığında, tek bir dayanağı olduğundan büyük göstermeden bunu Evidence ⊕ Mixed evidence Evidence: Mixed evidence ile belirtir. Bir sayfanın dayandığı standartlar, rozet satırında tam tanımlayıcılarıyla adlandırılır — örneğin Spec Spec: ISO 32000-2, §7 ISO 32000-2 §7 PDF söz dizimi için ya da Spec Spec: ETSI EN 319 142-1 ETSI EN 319 142-1 PAdES için — böylece başvuruyu kaynağa kadar kendiniz takip edebilirsiniz.

Uygulamalı örnek

Bir Insider_ sayfası hızlı okunacak şekilde tasarlanır. NextPDF’in imza işleme sürecinin düzenlemeye tabi bir iş akışına uygun olup olmadığına karar vermek için İmzalar bir PDF’in neresinde durur sayfasını açar, Bir bakışta ve Kısaca bölümlerini okur, ardından doğrudan Kısıtlamalar ve sınırlar bölümüne geçersiniz. Bu üç kısa bölüm, “bu tercihi savunabilir miyim” sorusunu yanıtlar. Rozet satırı, gövde metninden tek bir sözcük bile okumadan önce iddianın standart destekli olduğunu size çoktan söylemiştir.

Yanıt evetse, İlgili belgeler sizi arama yapmanıza gerek bırakmadan sonraki sayfalara yönlendirir — PAdES temel profilleri ve Uzun vadeli doğrulama.

Yaygın yanlış anlama

Insider_ bazen pazarlama sanılır: motorun övüldüğü bir yer. Tasarımı gereği bunun tam tersidir. Bir sayfa, size NextPDF’in nasıl kullanılacağını anlatmaya ne kadar istekliyse, ne zaman kullanılmaması gerektiğini anlatmaya da o kadar isteklidir. NextPDF’i bir rakiple asla aleyhte — ya da lehte — karşılaştırmaz. Buradaki tek konu NextPDF ve uymakla yükümlü olduğu standartlardır.

Kısıtlamalar ve sınırlar

Bu sayfa bir teknik şartname değil, yönlendirme sayfasıdır. Kendine ait herhangi bir motor davranışı ileri sürmez. Davranışa ilişkin her iddia, kendisine sahip olan konu sayfasında bulunur ve o sayfanın kanıt düzeyini taşır. Insider_ içeriği yorum niteliğindedir ve nextpdf-docs’a özgüdür. Burada yazılır, burada incelenir ve herhangi bir paketin kaynak ağacından derlenmez. Bir konu lisanslı bir standarda temas ettiğinde, sayfa ilgili maddeyi başka sözcüklerle ifade eder ve atıf verir. Standardın metnini asla birebir aktarmaz.

İlgili belgeler

• NextPDF tasarım felsefesi — her sayfanın ölçüldüğü ilkeler.
• Standartlar manzarası — NextPDF’in izlediği standartların haritası ve bir maddenin nasıl davranışa dönüştüğü.
• Bir ürün olarak belgeler — bu sayfaların ardındaki disiplin.
• Atıf disiplini — bir kanıt düzeyinin ne anlama geldiği ve standartların neden başka sözcüklerle ifade edildiği.

Sözlük

• Insider_ — API başvurusundan farklı olarak, NextPDF’in ardındaki gerekçeyi açıklayan yorum niteliğindeki bölüm. Sondaki alt çizgi, bölüm adının bir parçasıdır; yalnızca vurgu için renklendirilmiştir.
• Kanıt düzeyi — bir sayfanın iddiaları için bildirilen dayanak (kod destekli, standart destekli, test destekli, kıyaslama destekli, ürün-çıktısı destekli, tasarım ilkesi, yorum niteliğinde veya karma).
• Rozet satırı — her Insider_ sayfasının üst kısmında yer alan, ilgili standartları ve sayfanın kanıt düzeyini belirten şerit.
• nextpdf-docs’a özgü — bir paket deposundan türetilmeyen, belge sitesinin kendisinde yazılan ve sahipliği belge sitesine ait olan içerik.