Нужно ли документировать проект?

Всем доброго вечера.
Паттерны проектирования и Совершенный Код читать пока не планирую (так как начинающий), но некоторые вопросы узнать бы хотелось.
Я решил написать одно приложение, чтобы потренироваться, а впоследствии и опубликовать его под GPL-лицензией. Сначала все шло нормально, но сейчас количество кода превысило 1800 строк и ориентироваться в объектах и переменных стало крайне затруднительно. Стараюсь писать аккуратно и красиво, но периодически всё равно приходится делать глобальный рефакторинг, и это очень долго.

Нужно вообще, или полезно сделать какую нибудь систему именования переменных, или как запомнить все невидимые элементы GUI ? (Например менеджеры компоновки, невидимые распорки...да и вообще) Чертить схему на бумажке что-ли? Как с этим справляются проф. разработчики?
пишу на Qt.
Можете дать какие-нибудь советы? Спасибо

0

P.s. И еще: выше я писал, что doxygen не парсит .cpp файлы, а только интерфейсы. Глупая моя спешка: в настройках это все можно сделать. (Это вдруг кто-то из новичков будет читать тему и наткнется на такую неправду )

0

есть октрытые у гугла, фаерфокса, ну в общем у многих проектов и фирм они есть

Добавлено через 2 минуты
у меня лично этот документ занимает 40 стр, его чтение менее приоритетное занятие чем чтение Макконела

1

Сообщение от fasked Смысл писать какие-либо гайдлайны, если над проектом один человек работает?

Опять же, чтобы не запутаться. Если я не прав, то скажите, какими средствами пользуетесь вы чтобы превносить какой-либо порядок в систему?

0

лано щас октрою репозиторий на чтение svn://axi.su/vs-static/trunk/docs/coding_standards.odt
не хочу, чтоб левые версии ходили по инету.

Добавлено через 39 секунд

Сообщение от gromo Опять же, чтобы не запутаться. Если я не прав, то скажите, какими средствами пользуетесь вы чтобы превносить какой-либо порядок в систему?

он имеет ввиду, что писать не надо, а читать чужие можно ) для улучшения собственного стиля

0

Сообщение от gromo какими средствами пользуетесь вы чтобы превносить какой-либо порядок в систему?

Чаще всего это просто UML скетчи. Их хватает с головой для относительно взрослого средних размеров проекта.
Ваше желание, оно конечно похвальное, но для 2К строк кода игра не стоит свеч.

1

открыл репозиторий на чтение, надеюсь знаете как пользоваться SVN ...

0

XRuZzz, никогда не пользовался Если набрать
то получаем
ЧЯДНТ?

0

попробуйте так

1

Сообщение от XRuZzz попробуйте так Bash 1 svn checkout svn://axi.su/vs-static/trunk/docs/ ~/docs

Да, так скопировалось. Спасибо большое, почитаю с удовольствием.
Интересно, что документ в .odt неужели фирмы не запрещают пользоваться чем-то отличным от MS поделок?
А GCC тоже можно?

Добавлено через 4 минуты

Сообщение от XRuZzz http://oberoncore.ru/wiki/svn_quick-start

++. сам ничего внятного сходу не нашел. спасибо

0

Сообщение от gromo Интересно, что документ в .odt неужели фирмы не запрещают пользоваться чем-то отличным от MS поделок?

ага щазззз, я просто не распространяю наркотики...

0

0

Сообщение от gromo Интересно, что документ в .odt неужели фирмы не запрещают пользоваться чем-то отличным от MS поделок?

А я прошу прощения, с фига ли должны запрещать? OpenSource много где используется же.

0

Сообщение от ForEveR OpenSource много где используется же.

Это очень радует

0

Сообщение от gromo Это очень радует

только почему то не там где я работаю...(работал)

0