Содержимое
У Ивана Бегтина есть отличный (и несправедливо недооцененный!) проект "Простым языком" — https://www.plainrussian.ru/ — оценка сложности текстов на русском языке. Изначально он задуман для оценки понятности текстов государственных сайтов и законопроектов, но я попробовал запихнуть в него кусок ТЗ на информационную систему из одной госзакупки, ну просто для примера. Получилось, ожидаемо, "Очень сложно читать, уровень аспирантуры, второго высшего или PhD". Ну, это ещё ничего, бывает и сложнее. Вообще я эту ситуацию у всех наблюдаю - от школьников до опытных аналитиков: устно все очень понятно говорят, что должна делать система, а как только нужно записать - появляются монструозные конструкции и наукообразные тексты. Кто был у меня на тренингах, наверняка слышал от меня "вы очень хорошо сейчас сказали, просто запишите это! нет, нет, просто запишите дословно, что вы сказали!" Я попробовал немного переписать текст этого ТЗ, и сразу получил сложность на уровне 10-11 класса. Кажется, программистами должно гораздо лучше восприниматься. Замечу, что я пробовал несколько ТЗ, так сильно упростить не всегда получается, оптимальна, кажется, сложность на уровне 1-3 курса института - и её почти всегда удается добиться, если только не нужно приводить дословные цитаты из законов, они всё сразу усложняют 🙂 Загнал несколько своих старых ТЗ, получается стабильно сложность на уровне 1-3 курса. Заодно при упрощении текста появились новые вопросы и я исправил несколько ошибок. Когда текст становится проще, дыры в логике и пробелы в изложении становятся очевидными. Например, я выявил и убрал пару случаев тавтологии ("система должна отображать информацию X, включая информацию X"), в нескольких местах возникли вопросы по поводу разницы режимов работы системы ("система должна обеспечивать режим просмотра A и режим просмотра B, в режиме B не должны быть видны некоторые данные" -- какие данные? Кто и когда переключает режимы? и т.п., куча новых вопросов). Также стало очевидно, что в системе должен быть реализован алгоритм рекомендаций, никак не прописанный в ТЗ, тогда как до этого создавалось ощущение, что рекомендации просто поступают в систему снаружи -- всего лишь из-за пары безличных предложений и многократного использования слова "информация". В общем, интересный и полезный сервис, пользуйтесь! Напишите — какая сложность у вас получилось, очень интересно.