• Комментирование кода русским языком

      Вопрос комментировать или не комментировать код для меня вполне понятен, стараюсь придерживаться правил:

      — код сам себя должен себя документировать.
      — комментарии ради комментариев не нужны и вредны.
      — комментировать надо то, что может вызвать вопросы:
      чтобы выявить такие места надо постараться взглянуть на кусок кода чужими глазами.
      — в то же время если проект требует по каким-то причинам жесткого документирования,
      то надо придерживаться стандартов данного проекта, а не каких-то общих советов.

      А вот вопрос на каком языке комментировать мне не совсем ясен.
      Читать дальше →
    • Что почитать по проектированию архитектуры?

        Текущий проект на работе разросся до огромных размеров и продолжает расти.
        Так получилось, что большая часть была создана людьми, которые уже не в проекте. И качество кода многих компонент зачастую ужасно. Но все это работает, пользователи всем этим пользуются и потому русское
        «Это все никуда не годиться. Легче все написать заново» — не применимо.

        Проект построен на связке tomcat,struts c java-сервером работающим с postgres. С веб-частью(tomcat) вроде все нормально. В самом сервере каша — где сам функционал по работе с БД.

        На большой рефакторинг и обдумывание архитектуры обычно времени не хватает.
        В то же время новые решения/изменения вносятся регулярно и итерационное выправление структуры вполне применимо.
        Но как-то не уверен я, что вносимые изменения улучшают ситуацию. Скорее они не ухудшают.
        Не хватает опыта в разработке правильных архитектурных решений, в использовании шаблонов.

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

        уже есть(читал) по теме или близко:
        — Рефакторинг. Фаулер
        — Совершенный код. Стив Макконнелл
        — Архитектура корпоративных программных приложений. Фаулер (хорошая книга)
        — Еще какие-то одинаковые книги типа «Разработка корпор.приложений с помощью UML, J2EE» от
        Гради Буча и пр.

        Интересно не что-то общее из цикла типа RUP процессов разработки, а конкретно по архитектуре
        и шаблонам развертывания, на примере конкретных коммерческих проектов.

        Заранее спасибо за комментарии