Так воть, перейдём к вопросам:
1. Какой из этих вариантов лучше?
2. Стоит ли это документировать, если это код, с которым, скорее всего, буду работать только я? Если да, то где?
Откуда мы знаем где ты будешь работать?
Или ты предлагаешь нам тебе работу подкинуть?