Tangled.org, dokümantasyonunu düzenlemek ve https://docs.tangled.org adresinde yayınlamak için kendi özel çözümünü geliştirdi. Proje, monorepo içinde yaşama, JavaScript'siz çalışma, kolay aranabilirlik, düşük karmaşıklık ve kolay stilize edilebilirlik gibi belirli gereksinimleri karşılamayı hedefliyordu. Bu hedefler doğrultusunda Mintlify, Docusaurus, MkDocs ve MdBook gibi mevcut dokümantasyon motorları değerlendirildi. Mintlify'nin yapay zeka odaklı yaklaşımı, Docusaurus'un React SPA yapısı ve MkDocs ile MdBook'un manuel içindekiler tablosu (TOC) yönetimi gibi nedenlerle bu çözümlerden vazgeçildi. Özellikle JavaScript bağımlılığı, basit metin tabanlı dokümantasyon siteleri için gereksiz görüldü.
Ekip, tüm bu gereksinimleri karşılamak için Pandoc'u kullanmaya karar verdi. Pandoc, son derece özelleştirilebilir bir işaretleme dönüştürücüsü olup, dokümantasyon siteleri oluşturmak için ideal olan "chunkedhtml" çıktı formatını sunar. Bu format sayesinde otomatik olarak oluşturulan bir içindekiler tablosu elde edilir ve her bölüm ayrı bir sayfaya dönüştürülür. Uygulama sürecinde, tüm bireysel Markdown dosyaları tek bir büyük DOCS.md dosyasında birleştirildi. Varsayılan template, içindekiler tablosunu her sayfada bir "kenar çubuğu" olarak gösterecek şekilde değiştirildi ve Tailwind prose sınıfları, içeriğin site genelinde tutarlı bir şekilde render edilmesi için entegre edildi. Tüm dokümantasyon, tek bir Pandoc komutuyla kolayca oluşturulabiliyor.
Mobil ekranlarda kenar çubuğunun daraltılması gibi işlevler için JavaScript'ten kaçınmak da önemli bir hedefti. Değerlendirilen çoğu motor bu işlev için JavaScript gerektirirken, MkDocs :checked sözde sınıf hilesini kullanıyordu. Tangled.org ekibi, bu sorunu çözmek için <details> ve <summary> etiketlerini veya yeni popover API'sini kullanmayı değerlendirdi. Özellikle popover API'si, kenar çubuğu bileşeni için mükemmel bir uyum olarak görüldü ve JavaScript'e ihtiyaç duymadan modern ve erişilebilir bir deneyim sunma potansiyeli taşıyor.
Pandoc gibi basit ve güçlü bir aracın, özel gereksinimleri olan modern ve JavaScript'siz bir dokümantasyon sitesi oluşturmak için karmaşık framework'lere alternatif olabileceğini gösteriyor.