Через тернии к звездам: как мы перевезли всю документацию Яндекса на Diplodoc

Долгое время вся документация Яндекса существовала в формате dita — этот формат во многом подходил основным задачам документирования: переиспользование контента, возможность гибкой и удобной локализации, большое количество разнообразной верстки и использование единого источника. Кроме того, для dita существовали редакторы, которые позволяли писать тексты, не углубляясь в детали разметки.

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

О том, почему мы остановились на формате YFM и платформе Diplodoc, как прошла миграция и чему мы научились за этот период, расскажем в совместном докладе двух команд: Yandex Crowd и Diplodoc.