This results in absolutely delightful documentation with things like embedded DSLs (I have suffered slight trauma from Ruby ones) where the documentation contai

This results in absolutely delightful documentation with things like embedded DSLs (I have suffered slight trauma from Ruby ones) where the documentation contains 90% incomprehensible voodoo incantations that exist just to make the DSL look pretty.