220 replies to this topic

[Nila]

алгебра, русский 4, физика 5))

[Black soul]

Я тут ММ4 народу обещал.
http://narod.ru/disk...000/MM.rar.html

[hrulikus]

да. Ребят, я конечно не распространитель рекламы, но: Очень хороший сайт Димы Камаева. algmet.narod.ru Особо на него полагаться не стоит но лекции в нем есть и все это очень может пригодиться

[Black soul]

Спс,поюзаем сайтец)

[Nila]

спасибо))

[Black soul]

Может закрыть топ к чёртовой матери?)

[/79ITA4ok]

Тебе мешает?)

[stanok]

А собственно зачем?

[Black soul]

донт кноу

[Generator]

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

[Deimos]

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

Документация (Записка): Заголовок, заказчик, постановка задачи, основная структура (вот, типа, тут у меня главный класс, а вот так вот визуализация идёт), основные алгоритмы ("метод Зейделя:..." и формулы, и может даже вывод), подробный юзергайд (Ткнул сюда - получил то, а сюда - то). + код.

Вроде бы я ничего не забыл. Примерно такое от нас требовал Даниил Юрьевич, чуть меньше - Мариана Константиновна (без алгоритмов и структуры, но хоть как-то это обозначить надо).

Edited by Deimos, 10 October 2008 - 17:36 PM.

[Generator]

Спасибо, хотя у нас все проще вроде.)

[Black soul]

Марианна Константиновна сказала:написать коменты к строкам,потом она поспрашивает-и всё))

[Syrano]

Марианна сказала:написать коменты к строкам,потом она поспрашивает-и всё))

Федя, а давай немножко по-уважительнее?

[Black soul]

Федя, а давай немножко по-уважительнее?

Исправил

[Nila]

на самом деле я в документации велосипед изобретать не стала - взяла две, которые Марианна Константиновна показывала и выбрала самое удачное, почти написала уже)) а комменты я так и не писала. не вижу смысла, лучше в ворде документацию. могу выложить вторую, по которой я делала, вконтакт, это по заявкам. одна уже там есть у Оксаны Голенок.

[Syrano]

а комменты я так и не писала.
не вижу смысла, лучше в ворде документацию.

Если интересно, в чем смысл, могу рассказать.

[Nila]

Если интересно, в чем смысл, могу рассказать.

Интересно)))

[Syrano]

Интересно)))

В современном мире мало написать корректно работающую программу. Ее нужно поддерживать: добавлять новые возможности, корректировать. И делать это будет команда, а не один человек. "Мертвый" код никому не интересен. Код всегда меняется. Такова реальность.
Опыт показывает, что вести параллельно документацию почти нереально. Она безнадежно устаревает: одно в программе изменили, другое... а в документации не написали. Потом вспомнили, а кода понаписали уже, оказывается, столько, что проще новую документацию делать, чем старую исправлять. Вот и получается, что единственная документация -- это код.
То есть комментарии в программе нужны для того, чтобы, например, я мог внести изменения в код, который написала ты, при том, что тебя нет рядом. То есть в комментариях должны быть ответы на все вопросы, которые я тебе задам, разбираясь, в том, как написана твоя программа. Что именно должно быть написано -- очень сложный вопрос. Комментарии вида:
i++; //увеличиваем i на единицу
-- понятно, бесполезны. Но и трактат писать не нужно. Все равно не прочитают.
Чтобы понять, как именно должны выглядеть комментарии, возьми какую-нибудь свою программу. Придумай, что можно в нее добавить и попроси это сделать кого-нибудь из одногруппников, например. А на все вопросы вида "а что ты тут имела ввиду?" или "а как это у тебя работает?" -- ответы пиши комментариями к коду. Тогда что-то похожее на то, что нужно, у тебя и получится. На самом деле, очень полезный навык, так что если найдешь кого-нибудь, кто захочет поучаствовать в эксперименте -- не поленись, сделай. А сама в то же время поизучай программу, написанную этим человеком. И тоже, что не понятно, пусть пропишет комментарием.
Вот, как-то так.

[/79ITA4ok]

Вспомнилось) Я ненавижу человека, писавшего код, который я разбираю. Он болен. Страшно болен головой. Видимо, неизлечимо. И социально опасен. Нереально опасен. Я прекрасно понимаю людей, пишущих HTML-код. Более того, мне видится абсолютно логичным делать в нем Java-вставки, потому что иначе во многих случаях просто не получается. Я даже не особо матерюсь оттого, что часть вызываемых функций или процедур описана на Perl или Python. Но когда я вбиваю в гугл оператор, а мне вместо манов по Ruby (да-да, и такой код там тоже есть) выдается статья в википедии на гордом языке Bamanankan , я теряю самообладание. Для тех, кому написанный выше абзац не говорит вообще ни о чем, приведу аналогию. Представьте, что вы читаете книгу на русском языке. Периодически в ней встречаются абзацы на английском, которые вы тоже понимаете. С разной степенью успешности, но понимаете. И вот в тексте встречается глава, написанная китайскими иероглифами, причем все сноски в этой главе написаны на хинди, все, что в скобках - на санскрите, а занимающие полглавы стихотворные формы - на языке народности тора-бора. Думаю, вы уже поняли, что в дальнейшей части книги все слова длиннее 5 букв идут на латыни (причем если количество букв в слове четное, то еще и задом наперед), строки с седьмой по одиннадцатую каждой страницы зашифрованы ребусом, а эпилог написан на старословянском и вообще находится в другой книге.