Решение записано вместе с кодом
Рядом с каждым нетривиальным местом написано не только как сделано, но и почему так, и что было бы, сделай мы иначе. Через полгода это единственное, что отличает обдуманное решение от случайного, — и единственное, что мешает аккуратно вернуть уже исправленную ошибку.