Студопедия

КАТЕГОРИИ:


Архитектура-(3434)Астрономия-(809)Биология-(7483)Биотехнологии-(1457)Военное дело-(14632)Высокие технологии-(1363)География-(913)Геология-(1438)Государство-(451)Демография-(1065)Дом-(47672)Журналистика и СМИ-(912)Изобретательство-(14524)Иностранные языки-(4268)Информатика-(17799)Искусство-(1338)История-(13644)Компьютеры-(11121)Косметика-(55)Кулинария-(373)Культура-(8427)Лингвистика-(374)Литература-(1642)Маркетинг-(23702)Математика-(16968)Машиностроение-(1700)Медицина-(12668)Менеджмент-(24684)Механика-(15423)Науковедение-(506)Образование-(11852)Охрана труда-(3308)Педагогика-(5571)Полиграфия-(1312)Политика-(7869)Право-(5454)Приборостроение-(1369)Программирование-(2801)Производство-(97182)Промышленность-(8706)Психология-(18388)Религия-(3217)Связь-(10668)Сельское хозяйство-(299)Социология-(6455)Спорт-(42831)Строительство-(4793)Торговля-(5050)Транспорт-(2929)Туризм-(1568)Физика-(3942)Философия-(17015)Финансы-(26596)Химия-(22929)Экология-(12095)Экономика-(9961)Электроника-(8441)Электротехника-(4623)Энергетика-(12629)Юриспруденция-(1492)Ядерная техника-(1748)

Документирование программы

Программа, если она используется, живет не один год, и необходимость вносить в нее какие-то изменения и дополнения появляется сразу же после ввода в эксплуатацию. Сопровождение программы занимает гораздо больший промежуток времени, чем ее написание, поэтому документирование программы имеет очень большое значение. Основная часть документации должна находиться в тексте программы. Хорошие комментарии написать почти так же сложно, как и хорошую программу. Даже если сопровождающим программистом является автор программы, разбираться через год в плохо документированном тексте — сомнительное удовольствие.

В идеале комментарии должны создаваться до написания программы — ими служит подробный алгоритм, изложенный на естественном языке. Очень полезно до начала кодирования подробно записать, что и как должна делать программа (подпрограмма). Это помогает в деталях продумать алгоритм и интерфейсы, найти на самой ранней стадии серьезные ошибки и обеспечить содержательные комментарии. После такой работы программирование сводится к вставке фрагментов кода между комментариями. Подходить к написанию программы нужно таким образом, чтобы ее можно было в любой момент передать другому программисту.

Комментарии должны представлять собой правильные предложения без сокращений и со знаками препинания и не должны подтверждать очевидное.

Если комментарий к фрагменту программы занимает несколько строк, лучше разместить его до фрагмента, чем справа от него, и выровнять по вертикали. Абзацный отступ комментария должен соответствовать отступу комментируемого блока.

Для разделения подпрограмм и других логически законченных фрагментов пользуйтесь пустыми строками или комментарием вида

{_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ }

Конечно, все усилия по комментированию программы пропадут втуне, если сама она написана путано, неряшливо и непродуманно. Поэтому любую программу после написания необходимо тщательно отредактировать: убрать ненужные фрагменты, сгруппировать описания, отформатировать текст, оптимизировать проверки условий и циклы, проверить, оптимально ли разбиение на функции и т. д. С первого раза без помарок хороший текст не напишешь, будь то сочинение, статья или программа.

Однако не следует пытаться оптимизировать все, что попадается под руку, поскольку главный принцип программиста тот же, что и врача: «Не навреди!» Если программа работает недостаточно эффективно, надо в первую очередь подумать о том, какие алгоритмы в нее заложены. Полезно также проанализировать программу с помощью профайлера, выявить узкие места и оптимизировать только их.

 

<== предыдущая лекция | следующая лекция ==>
Правила программирования | Показатели результатов экономической деятельности
Поделиться с друзьями:


Дата добавления: 2014-01-04; Просмотров: 433; Нарушение авторских прав?; Мы поможем в написании вашей работы!


Нам важно ваше мнение! Был ли полезен опубликованный материал? Да | Нет



studopedia.su - Студопедия (2013 - 2024) год. Все материалы представленные на сайте исключительно с целью ознакомления читателями и не преследуют коммерческих целей или нарушение авторских прав! Последнее добавление




Генерация страницы за: 0.011 сек.