Restructure par_decimator and add documentation

[ed-xmos]

See here a point by @huw which suggests some useful updates with regard to customisation and in particular parallel decimation.

xmos/sln_voice#308 (comment)

[huw]

(You probably want @xhuw)