Про REST - я начал его использовать

В связи с необходимостью писать документацию на публикуемые модули, пришлось-таки начать использовать ReST. Вроде даже освоился и ничего так, пишу. Хуже обстоят дела с англоязычной документацией - но тоже стараюсь писать. Примерно по принципу один пример заменяет тонну документации. Это помогает. Ну, посмотрим что будет дальше - количество просмотров там и типа того.

В конце-концов качество документации определяется не качеством языка, а ее понятностью. А качество языка может быть и так себе.