Add some comments, and tweak some documentation.
Add some comments, and tweak some documentation.

bsmedberg/socorro,twobraids/socorro,cliqz/socorro,luser/socorro,bsmedberg/socorro,lonnen/socorro,yglazko/socorro,Serg09/socorro,rhelmer/socorro,pcabido/socorro,linearregression/socorro,linearregression/socorro,luser/socorro,AdrianGaudebert/socorro,KaiRo-at/socorro,adngdb/socorro,Tchanders/socorro,linearregression/socorro,luser/socorro,lonnen/socorro,spthaolt/socorro,rhelmer/socorro,cliqz/socorro,twobraids/socorro,spthaolt/socorro,linearregression/socorro,cliqz/socorro,lonnen/socorro,Tayamarn/socorro,spthaolt/socorro,twobraids/socorro,linearregression/socorro,cliqz/socorro,adngdb/socorro,bsmedberg/socorro,spthaolt/socorro,mozilla/socorro,pcabido/socorro,pcabido/socorro,bsmedberg/socorro,m8ttyB/socorro,yglazko/socorro,AdrianGaudebert/socorro,KaiRo-at/socorro,mozilla/socorro,AdrianGaudebert/socorro,Tayamarn/socorro,m8ttyB/socorro,yglazko/socorro,mozilla/socorro,twobraids/socorro,rhelmer/socorro,KaiRo-at/socorro,Tchanders/socorro,spthaolt/socorro,m8ttyB/socorro,Tayamarn/socorro,Tayamarn/socorro,twobraids/socorro,bsmedberg/socorro,m8ttyB/socorro,pcabido/socorro,rhelmer/socorro,m8ttyB/socorro,adngdb/socorro,adngdb/socorro,mozilla/socorro,mozilla/socorro,adngdb/socorro,m8ttyB/socorro,Serg09/socorro,KaiRo-at/socorro,adngdb/socorro,Serg09/socorro,luser/socorro,KaiRo-at/socorro,pcabido/socorro,yglazko/socorro,yglazko/socorro,Tchanders/socorro,spthaolt/socorro,Serg09/socorro,pcabido/socorro,Tayamarn/socorro,rhelmer/socorro,Tchanders/socorro,AdrianGaudebert/socorro,mozilla/socorro,KaiRo-at/socorro,Serg09/socorro,luser/socorro,twobraids/socorro,AdrianGaudebert/socorro,linearregression/socorro,yglazko/socorro,lonnen/socorro,AdrianGaudebert/socorro,Serg09/socorro,cliqz/socorro,Tchanders/socorro,Tayamarn/socorro,Tchanders/socorro,luser/socorro,cliqz/socorro,rhelmer/socorro