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