python: add flux.job.list docstrings

[wihobbs]

This doesn't fully document the job.list module but I think it's a good start.

[grondo]

Thanks for doing this. A few comments and corrections inline.

[jameshcorbett]

Can you add a commit body? I think

Problem: some flux.job.list functions are missing docstrings.

Add them.

Would do it.

[wihobbs]

Thanks guys, I think I got all your corrections.

[jameshcorbett]

LGTM but you dropped the commit body :/

[jameshcorbett]

LGTM, thanks @wihobbs !

[codecov]

Codecov Report

Merging #5500 (3e8fd51) into master (c26f97f) will increase coverage by 0.02%.
The diff coverage is n/a.

@@            Coverage Diff             @@
##           master    #5500      +/-   ##
==========================================
+ Coverage   83.67%   83.70%   +0.02%     
==========================================
  Files         484      484              
  Lines       81537    81537              
==========================================
+ Hits        68228    68250      +22     
+ Misses      13309    13287      -22     

Files	Coverage Δ
src/bindings/python/flux/job/list.py	96.77% <ø> (ø)

... and 12 files with indirect coverage changes

[jameshcorbett]

Ok to set MWP @grondo @wihobbs ?

[jameshcorbett]

Checked with Hobbs, setting MWP.