fix bug 1085623 - reorg Socorro docs

r? anybody - I know @lonnen is interested, maybe if @erikrose could take a look (it's inspired by DXR's excellent docs)