Added comments, broke into methods.
Most important non trivial changes.

I simplified the router by changing the level of
round robbin routing to shards (when several are available.)

Instead of roundrobbin at the document scale,
this round robbins over shards at each ingest requests.

This simplifies the code in charge of dispatching
ingest subrequests.