Как собрать лучшие практики личного или организационного программирования? - PullRequest
0 голосов
/ 20 мая 2018

... или, какова лучшая практика для сбора лучших практик?

Обратите внимание, что я не спрашиваю, что это за лучшие практики ;они могут варьироваться от человека к человеку, от команды к команде, от языка к языку, от домена к домену.

Чтобы пояснить, мне любопытно, есть ли что-нибудь, приближающееся к стандарту для сбора лучших практик кодирования, например ...

Пример лучших практик

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

... и т. Д.на.Очевидно, этот список может продолжаться вечно!

Что я подразумеваю под захватом?

Я имею в виду кодирование этих лучших практик таким способом, который наиболее полезен.

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

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

Решения, которые мне известны

  • Объединение таких классических вещей, как Чистый код или КодComplete, который не настраивается или не зависит от домена,
  • Использование инструментов, таких как checkstyle , которые не могут захватить туманность, или
  • Создание пользовательской документации.

Есть что-то лучше? Спасибо!

...