Я люблю Яндекс.
В силу текущих должностных обязанностей столкнулся с форматом Маркет.Яндекс.

Чтобы как-то с ним работать, добрался до описания формата. Цензурных слов после недельного общения с этим документом становится всё меньше и меньше.

Яндекс, вы - большая компания. Неужели так сложно найти хорошего технического писателя, и один раз на ревизию вычитывать созданный разработчиками текст?

Посреди текста в конце раздела описания элементов формата - вдруг незаметная фраза: "Элементы, которые не были описаны в примерах, являются резервными и не обрабатываются." Зачем добавлять в DTD элементы, которые игнорируются? (Нецензурное слово) И как же надо не любить собственных клиентов, чтобы заставить их шерстить примеры, и выяснять, какие элементы являются необрабатываемыми? (Много нецензурных слов)

Версионирование. (Нецензурное слово) Уже шесть версий вышло, однако. Понимаю, что хозяин - барин, и холопы (клиенты) подсуетятся и быстренько переделают свои источники под новый DTD, но выяснить, какому именно shops.dtd соответствует некий список товаров, не представляется _никакой_ возможности.

DTD, как отдельно скачиваемого документа, нет. Будьте любезны выдернуть его со страницы. Кстати, у меня создалось впечатление, что этот текст не соответствует тому shops.dtd, который используется самим Яндексом.

Количество мелких замечаний исчисляется десятками...

А ещё это претендует на документ в смысле юридическом, ага.

Завершая, (много нецензурных слов).