Что я думаю про документацию кальки
(или "100500 причин - почему документации Кальки требует доработки")

Блог Всячепуза,
 
(даже не знаю, стоит ли завести столько багов в багтрекере).

1. http://www.calculate-linux.ru/main/ru/about_the_calculate_linux_installation
2. Если написано "мы постоянно работаем" - должна быть ссылка на ченджлог конкретно по этому направлению работы, в логе должны быть выполненные мероприятия с датами, чтобы было видно, что работаете действительно постоянно (ну и ссылки на достигнутые результаты)
3. "Удобство работы" - должна быть не одна ссылка, а две - первая на общие design principles, вторая на руководство пользователя (как это сделано сейчас)
4. "Stage4-образа" - должна быть ссылка на описание того, что вообще такое все эти stage, потому что stage4 - это непонятное слово.
5. "Во время загрузки с LiveCD и установки системы на компьютер утилиты Calculate настраивают систему при помощи шаблонов" - фраза тяжело парсится. "во время загрузки утилиты" - надо было вынести вперед подлежащее и сказуемое - "утилиты настраивают".
6. "точную копию" - а что пользователю даёт точность копии, как производятся замеры точности и в чём точность заключается?
7. "все опции установки" - угу, а могут быть переданы и не все опции? Или опции не этой утилиты? или имеется в виду, что это фронтэнд к другой утилите и можно передать все опции этой другой утилиты?
8. "Существующие пользователи будут перенесены, установка из Stage4 происходит путем распаковки." - с этого надо было начинать? или это достойно отдельной страницы? или правильно было бы назвать это фичей и дать нй маркетинговое имя, чтобы упоминать в списках? (например функция "персональный комплект настроек в LiveCD")
9. "Вы легко можете изменить настройки и состав программ, создав изменённый ISO-образ или обновив squashfs-файл на USB Flash."
да мне не программы важны, а мои бесценные данные. Как обстоит с работой с ними из этого образа?
ок, отрекламировали функцию "interactive system build" - где можно ознакомиться со всем списком функций, отличающих calculate от генты?

10. "Сервер утилит, консольный и графический клиенты входят в состав Calculate Linux, но могут быть установлены из оверлея Calculate в любом Gentoo-совместимом дистрибутиве."
здесь неясно, видимо имелось в виду "не входят"? Нет. Надо читать более внимательно. Они не входят в другом дистрибутиве (типа sabayon или gentoo), но можно подключить оверлей и установить.

Дальше я эту документацию осилить не смог, меня воротит от того как мерзко она написана.