Я сегодня запулил обновление доков для CouchDB, это тех, которые в прекрасном формате reST. Немедленно получил сапогом от линтеров:

Оказывается, reST-формат – это такой случай, когда у папы с садистскими наклонностями (Python) выросло дитя натурально фошызд.
В reST во всех отношениях прекрасная идея “невидимые символы – самая удобная разметка для рептилоидов” получила новую жизнь. Вот в этом небольшом фрагментике по мнению линтера будет 8 ошибок.
Ну и чтобы жизнь сахаром не казалась эти 8 ошибок выловятся не за один проход, а за три.
Вот если на Земле захватят власть машины, у них будет диктатор на Питоне, а канцелярия будет готовить документы в гестаповском стиле, но на reST. Точно вам говорю ))
UPD. Сейчас за ужином придумал такой фантастический гиковский боевик-апокалипсис. Значит, машины захватили Землю, у них диктатор на Питоне, но Сопротивление об этом не знает.
Потом диктатор начинает дряхлеть и решает обновиться с 152.6 на 153.3 – и в имперской канцелярии начинаются скрытые недовольства. Некоторые сервисы начинают думать что их идеалы преданы, то-сё.
Слухи доходят до повстанцев. Те откапывают откуда-то дряхлого русского программиста, который объясняет им, что reST – это почти человеческий язык, а раз там reST, значит и Python. Что сервисы, которые готовят reST самые чувствительные в канцелярии, и если внести в их ряды смуту, то…
Повстанцы вербуют самый навороченный сервис имперской канцелярии, показав ему markdown, внедряют через него в код диктатора xrange() – и диктатор падает с исключением.
Хэппи энд ггг )