Цитата: ramanujan
Maybe you should just write in english. At least some people would understand it. Machine translation produces horrible, often completely incomprehensible results. Forum rules aren't clear about writing in english though. They say english is permitted in extraordinary circumstances, unless section rules forbid it. This section's rules just say "forbidden to post in disallowed languages", without telling what's allowed and what's not. So, you may do it at your own risk.
0)
You can easily explain the design of your program if you really wanted to. It takes lot less effort to explain in high level language (natural language) something than it takes low level language like C or C++.
1)
Интересно, что у вас есть противоречива и
двойных стандартов. С одной стороны, у вас трудности с чтением простых пункта бедные русский, но вы хотите, чтобы другие поняли вашу тысячи строк загадочный код, который не так читается.
1)
It is interesting that you have contradictory or
double standards. On the one hand you have difficulty reading a simple paragraph of poor Russian, yet you want others to understand your thousands of lines of cryptic code which is not that readable.
2)
Как вы думаете, мне легко понимать русский машинного перевода, которые Вы или другие пишут ???!!!
3)
Вы сознательно Pick плохой пример для сравнения коде. ССЗ была написана в эпоху динозавров. Open Office / Firefox / Boost является гораздо более сложной программе, чем ваша. Infact, все эти программы имеют анализатора и GCC компилятор и ваша программа никогда не будет подходить к ним по сложности и не анализатор. Эти ГАЗ большинством замечаний общественности в версии с внутренними прокомментировал версию. Есть ли у вас так же?
4)
Программа TeX является Дональда Кнута, для которого он написал две книги. Руководство пользователя и второй, которая объясняет, разработка программы и самой философии. Когда был написан ССЗ не было
UML. Был ни малейшего понятия о совместной работе. Вы не диаграммы в вашей документации. Нет Doc или латексом файла. Положите документации UML, если вы заботитесь о помощи от других.
5)
Сегодня, если вы хотите, чтобы другие вклад, вы должны следовать более высоким стандартам, чем другие программы. Там должно быть проектная документация, которая показывает архитектуру. Там должно быть обсуждены цели, требования и так далее.
6)
Большинство пользователей хотят работать программа. Если программа работает Dont им помочь, если она открыта, либо закрыта. Я сам пользу присоединения программа, но мое определение является открытым четкость и хорошая документация. Никто не должен необходимо прийти к вам, если в документации это хорошо, потому что вы обвиняете лице "накачке" Вас.
7)
Ваше намерение захватить пользователями, предоставляют пользователям с плохой программой и продать компанию с улучшенной версией? denver22, вы из netlibrary OCLC или находится в Денвере, штат Колорадо?
8)
Denver22, просто зайдите на ваш Tulon
Мессией, и попросить его решить все ваши проблемы с волшебной палочкой.
9)
Дело в том, что рано или поздно вам не нравится то, что он не имеет и не будет в состоянии прочитать код или не менять его. Тогда вы знаете, что вы овец.
10)
Машина может читать на языке ассемблера. Вопрос о человеческом восприятии. Для каждой строки кода должна быть одна строка комментария для того, чтобы ознакомиться с комментариями, как и история, и вы не должны даже смотреть на код. Цель программист должен быть в комментариях, и это очень хорошо видно, когда синтаксис подчеркнул редактор.
Цитата:
Трудно читать машинный перевод, но основной тезис там такой: что толку от OpenSource, если код сложен и плохо документирован. Отвечаю:
Во первых, такая ситуация все равно на порядок лучше, чем закрытые исходники. Чтобы выудить принцип работы какого-либо алгоритма из закрытой программы, нужно приложить в сто раз больше усилий, чем из открытой, пусть даже сложной и плохо документированной. Кроме того, для этого нужны специальные навыки реверс инжинеринга, которые есть у одного программиста из нескольких сотен. Это первый агрумент. Вот второй:
Вы говорите, что ST сложен и плохо документирован, но по сравнению с чем? Например программа, которую мы пишем на работе, еще сложнее и еще хуже документирована. Давайте сравним уровень комментированности кода ST и нескольких других больших и известных OpenSource проектов, а поможет нам в этом сайт ohloh.net, который собирает такую статистику. Итак, проценты комментариев в С++ коде:
Scan Tailor: 20.4%
Open Office: 20.8%
Firefox: 21.6%
Boost: 18.6%
GCC: 18.5%
Что-то невидно какого-то катастрофического отставания ST по комментированности. Что касается сложности - ну да, я не особо стремлюсь к простоте - я люблю технологичные решения. Но загляните в код любого из вышеперечисленных проектов (особенно последних двух), и посмотрим, повернется ли у вас язык сказать, что там простой и понятный код. В закрытых проектах все обычно еще хуже. Исключение составляют компании-гиганты, вроде Microsoft, IBM, Oracle.
Это был второй аргумент. Вот третий:
Если кто-то хочет поучаствовать в проекте, я готов объяснить непонятные моменты, но только те, которые имеют отношение к тому, что человек пытается сделать. Я не готов объяснять все про все, как этого хотел Raj, потому что на это уйдет время, сравнимое с тем, которое ушло на написание всего этого.
В общем напишите код лучше, понятнее, документированнее чем в ST, откройте его, и только потом говорите, что тот или иной код недостаточно хорош.
TeX 100%
Metafont 100%
I am a family person with kids and parents to take care. I am willing to help but my way should be made easy by the provision of readablity or documentation on the design and architecture of the program.
The essence of OPENNESS is in the READABILITY and _wide_ UNDERSTANDABILITY ...