extensive inline documentation for depot.py