How do you guys document your models?

I work at a company that does quantitative pricing for sporting events. We have a variety of models, but there is no documentation. To understand how a model works, you need to read through the code. Now, I'm in favour of writing good code such that someone CAN read through it to understand what is going on. However, I believe there are certain benefits to having a document that outlines the approach, compares it with others etc. While we produce …

code datascience document documentation events good pricing quantitative through work writing