Заметь, я ниже сказал про систему управления знаниями. Которая должна быть едина, и которые имеет интерфейс как к программисту, так и к компилятору. Описанный тобой кусок отлично описывается в виде графа, причем в виде компактного представления. Текстовая часть может раскрываться "при наведении мышкой".
Ключевой вопрос - это иметь систему сопоставления конкретного куска кода и набора правил, которые к нему относятся.