docs: improve descriptions of extension manifest fields
Created by: chrismwendt
Continuation of https://github.com/sourcegraph/sourcegraph/pull/358 cc @felixfbecker
This PR does not need to update the CHANGELOG because it only includes small docs tweaks