Website Specification: iyi bir sitenin teknik gereksinimleri için açık kaynak rehber

«Website Specification» adlı açık proje, iyi bir web sitesinin sahip olması gereken teknik özellikleri, sitenin hangi teknolojiyle kurulduğından bağımsız olarak tek bir yerde topluyor. Belgeyi Joost de Valk ve katkıcılar sürdürüyor; çalışma GitHub'da açık biçimde yürütülüyor, kod MIT, içerik ise CC BY 4.0 lisansıyla yayımlanıyor.

Doctype'tan DNSSEC'e on başlık

Belge on başlığa ayrılmış. «Temeller» bölümü her HTML belgesinin gerektirdiklerini kapsıyor: doctype, geçerli bir BCP 47 lang özniteliği, ilk 1024 baytta UTF-8 bildirimi ve kullanıcının yakınlaştırmasını asla engellemeyen viewport meta etiketi. SEO bölümü RFC 9309 ile standartlaşan robots.txt'yi, XML site haritalarını ve site haritası dizinlerini, JSON-LD yapılandırılmış verisini, başlık hiyerarşisini, iç bağlantıları ve IndexNow'u ele alıyor; bu protokol Bing, Yandex, Naver ve Seznam'a ulaşıyor, ancak Google'a ulaşmıyor.

Erişilebilirlik maddeleri her görsel için alt metin, klavyeyle tam kullanım, görünür odak göstergeleri, içeriğe atlama bağlantıları ve katmanlar için inert özniteliğini şart koşuyor. Güvenlik bölümü TLS 1.2 veya 1.3 ile HTTPS, Content Security Policy, X-Content-Type-Options: nosniff ve DNSSEC'i kapsıyor. Kalan bölümler well-known URI'leri, ajanlara hazırlığı, performansı (modern görsel formatları, brotli ve gzip sıkıştırma, ETag doğrulayıcıları), gizliliği, dayanıklılığı — doğru 404 ve 500 sayfaları, bakım sırasında Retry-After başlıklı 503 — ve uluslararasılaştırmayı ele alıyor; buna hreflang ve ziyaretçilerin IP adresine göre yönlendirilmesine karşı uyarı da dahil.

Ajanlar için de yazıldı

Spesifikasyonun her sayfası ham Markdown olarak iki yolla erişilebilir: adresin sonuna .md ekleyerek ya da kanonik adrese Accept: text/markdown başlığı göndererek; bu durumda yanıt Content-Location başlığı ve önbellekler için Vary: Accept ile birlikte Markdown döner. Tüm içerik tek bir llms-full.txt dosyasında birleştirilmiş. mcp.specification.website adresindeki durumsuz MCP sunucusu, kimlik doğrulama olmadan search, list_topics, get_topic, get_checklist ve audit_url araçlarını sunuyor; ajanlar için bir beceri dosyası da /.well-known/agent-skills/ altında yayımlanıyor.

Kendi kurallarına uyan bir site

Projenin kendisi bu kuralların örneği. Astro ile üretilen ve GitHub'dan Cloudflare Pages'e dağıtılan statik bir site, yanıt başlığı olarak sıkı bir Content-Security-Policy, eksiksiz güvenlik başlıkları, /.well-known/security.txt, robots.txt, site haritası dizini ve RSS akışı sunuyor. Kaynaklar içerik şemasının parçası — kaynak bağlantısı olmayan bir sayfa birleştirilmemeli. Düz bir kontrol listesi ve kopyalanmaya hazır Markdown görev listesi tüm spesifikasyonu özetliyor; ayrı bir sayfa ise bilinçli olarak dışarıda bırakılan standartları ve bu kararı neyin değiştireceğini belgeliyor. Benzer bir proje aynı yaklaşımı e-postaya uyguluyor.

Site denetimi yapan ekipler için değer tek bir kuralda değil, zorunlu olanı yalnızca önerilenlerden ayıran tek bir referansta ve bir tarayıcının ya da ajanın doğrudan kullanabileceği makine okunur sürümünde.