major changes

new document write up,
model extensions
dynamic popularity