new docs for debugging and roadmap, plus explanation of :fields keyword for gather