?

Log in

No account? Create an account
Про RTFS - Журнал Витуса.
[Друзья] [Свежие записи] [Dreamwidth] [Фото] [Тексты] [Друзья Ирины] [Матерные писатели] [Сообщества] [3 круг]
December 26th, 2010
11:03 am
[User Picture]

[Link]

Previous Entry Share Next Entry
Про RTFS
Использование RTFS с большими и развесистыми программными комплексами, к которым нет грамотного concept manual, провоцирует на "легкий очевидный и неправильный" способ решения проблем.

Для того чтобы посредством RTFS понять высшие уровни абстракции, через которые проходит путь к правильному решению, нужно а) прочитать значительную часть исходников, чтобы получить представление о картине в целом, б) выстроить у себя в голове эти высшие уровни.

В то время как если бы разработчик не поленился написать пять страничек вводного текста, которые бы doxygen поместил на первую страницу, потребовалось бы читать на порядок меньше исходников (так как было бы сразу понятно какие именно исходники читать, и чего от них ожидать).

К сожалению, многие авторы это ленятся не то что записать - сформулировать для себя.

Чем-то мне работа человека, который посредством RTFS восстанавливает подобные концептуальные модели по коду (да, я этим умею занинматься, и делаю это профессиональн) напоминает работу пожарного или следователя. Дело нужное при нынешнем состоянии общества, но по хорошему счету грязная работа, которой бы хотелось избежать

Tags: ,

(49 comments | Leave a comment)

Comments
 
[User Picture]
From:Шура Люберецкий [luberetsky.ru]
Date:December 26th, 2010 08:18 am (UTC)
(Link)
А ведь есть еще люди, которые такие исходники продают (!). Не буду показывать пальцем, но им должно быть стыдно.
[User Picture]
From:vitus_wagner
Date:December 26th, 2010 04:22 pm (UTC)
(Link)
Тех, которые продают, можно пожалеть. Им же потом это саппортить. И вообще человека, творящего зло за деньги можно понять. У него дома дети голодные, может жена больная или на второй золотой унитаз не хватает.

Но когда человек творит такое же самое в порядке хобби, да еще публикует чтобы снискать славу среди коллег...
[User Picture]
From:beldmit
Date:December 26th, 2010 08:19 am (UTC)
(Link)
Археопрограммирование первого уровня...
[User Picture]
From:nasse
Date:December 26th, 2010 09:52 am (UTC)
(Link)
:)
[User Picture]
From:amarao_san
Date:December 26th, 2010 09:23 am (UTC)
(Link)
Ага. С другой стороны RTFS даёт окончательные ответы на ВСЕ вопросы.
[User Picture]
From:vitus_wagner
Date:December 26th, 2010 09:33 am (UTC)
(Link)
1. Не дает.
1.1. Он не дает ответа на вопрос "что курил автор". А когда читаешь исходник написанный без грамотной, отрефлексированной концепции в голове, этот вопрос обязательно приходит в голову.
1.2. Количество времени, которое потребно чтобы получить ответ на эти вопросы слишком велико.

2. Мне не нужны ответы на ВСЕ вопросы. Их просто голова не вместит. Мне нужны ответы на те вопросы, которые мне хочется задать. В том числе и по результатам ответа на предыдущие вопросы. И чем этих вопросов меньше, тем лучше. Какой-то гуманитарий мне тут пытался утверждать что лучшей моделью кошки является другая кошка, а идеальной - та же самая кошка. Так вот нет. Модель - это знания упакованные и очищенные от незначимого. Чем лучше они упакованы тем модель ценнее, то есть тем лучше она позволяет решать практические задачи.
[User Picture]
From:krocodl
Date:December 26th, 2010 11:08 am (UTC)
(Link)
+5!
эта компьютерная археология достала страшно. Особенно когда авторы только недавно начитались каких-нибудь модных идей типа паттернов, а потому ни слова в простоте написать не могут. Или увлекаются аспектами, интерцепторами и т.д., что делает поведение системы на первый взгляд просто невозможным.
[User Picture]
From:anonym_mouse
Date:December 26th, 2010 11:39 am (UTC)
(Link)
Мелкая поправка:
нельзя говорить RTFM в вашем смысле. Эта аббревиатура
заменяет фразу "читай ёбаную документацию"

Вы же хотели сказать просто о "ёбаной документации", а
потому верно было бы употреблять "TFMs" = the fucking manuals

P.S. да, а требование к компьютерным авторам кратко описать
"главную стратегическую идею" их произведения абсолютно
справедливо. Чтение исходников всегда оставляет пщущение, что
ты "понимаешь каждое слово", но совершенно не понимаешь общего
смысла, цели сказанного.
Для понимания нужно точно наоборот: каленым железом и девятих-
востками выбивать из программистов изложения сути и связывающих
идей на высоких уровнях, для чего эти понятные в малом слова
вообще были писаны.
[User Picture]
From:toshische
Date:December 26th, 2010 11:44 am (UTC)
(Link)
Обратите внимание, что Витус писал не про RTFM, а про RTFS, то есть про ситуацию, когда в качестве "документации" выступают непосредственно исходные тексты.
[User Picture]
From:anonym_mouse
Date:December 26th, 2010 11:49 am (UTC)
(Link)
Yep. So, the correction must be:
RTFS -- TFS
(Deleted comment)
[User Picture]
From:vitus_wagner
Date:December 26th, 2010 05:06 pm (UTC)
(Link)
Увы, не спасет. Там где стандарт оформления картинок называют "языком" (UML) правды быть не может.

Вообще, "как вы яхту назовете, так она и поплывет". Поэтому аббревиатура OMG говорит о многом.

Кстати, после работ Остерхута в начале 90-х, приведших к появлению почти забытного ныне Tk, никаких серьезных проработок моделей пользовательского интерфейса практически не было.


(Deleted comment)
(Deleted comment)
(Deleted comment)
(Deleted comment)
(Deleted comment)
(Deleted comment)
(Deleted comment)
(Deleted comment)
(Deleted comment)
(Deleted comment)
(Deleted comment)
(Deleted comment)
(Deleted comment)
(Deleted comment)
(Deleted comment)
From:rainbow_beast
Date:December 27th, 2010 12:39 pm (UTC)
(Link)
Вообще, для большого открытого проекта (с открытым кодом, в смысле) самый большой грех - это не обилие багов, не тормозность разработки и даже не закрытость принятия решений - это всё форками лечится, если припрёт. А вот отсутствие внятно описанной архитектуры (как минимум - какие есть логические компоненты, как их предполагается использовать и почему сделано именно так) делает почти невозможными какие-либо правки сторонними людьми.
[User Picture]
From:permea_kra
Date:January 2nd, 2011 10:22 am (UTC)
(Link)
К слову про RTFS. Витус, можете ткнуть пальчиком в образцовую реализацию flex-like с документированными сорцами? В идеале, не на сях.
[User Picture]
From:vitus_wagner
Date:January 2nd, 2011 10:50 am (UTC)
(Link)
Под flex-like имеется в виду генератор лексических анализаторов или что?
Честно сказать не знаю насчет лексических анализаторов. Парсеры, это да, иногда имеет смысл писать с использованием всяких yacc-ов, но лексер - штука настолько простая что правильнее ее писать руками на языке среднего уровня.
My Website Powered by LiveJournal.com