Еще немного логики.
Документация и прочие объяснялки к программе могут быть:
1. в отдельном [электронном] документе;
2. выдаваться программой по месту;
3. выдаваться программой в виде подсказок и комментариев;
4. включаться в программу в виде комментариев;
5. в виде программы, состоящей из самодокументирующихся программных структур:
6. включаться в программу в виде самодокументирующихся идентификаторов;
7. написания программы на языке, близком к естественному.
Причем,
8. существуют инструменты преобразования одного вида в другой;
9. чем неформальнее документация, тем лучше;
10. всякие программистские социалки, наоборот, сводят документирование к типовой пляске с бубном.
Что русифицировать будем?