Reorganizing code intelligence documentation and adding feature sections

Created by: christinaforney

I tried to add a section for you for references and got a little carried away, but I think this is an improvement! @efritz can you help fill in some brief details and improve the first draft wording I made?