В случае дизайна чего-либо нового либо массивного рефакторинга чего-либо старого следует явным образом записывать, _зачем_ делаются эти нововведения/изменения.
+1общие соображения (почему/Как/зачем) редко документируются но таки весьма важны.
+1
общие соображения (почему/Как/зачем) редко документируются но таки весьма важны.