Following the work we have been doing to implement the pyOpenSci suggestions in SciCM, I think now is a good time to give a comprehensive update to the splotch README file. It will improve the usability and (visual appearance) of the package, so I think we should follow the same guidelines, regardless of whether we decide further down the line to submit this package to pyOpenSci/JOSS. I also think it makes sense to combine this issue #30 for our next release.
Yes, agreed with lumping this together with Params. Especially because the usage of params probably needs it's own quite detailed documentation to be used effectively.
Following the work we have been doing to implement the pyOpenSci suggestions in SciCM, I think now is a good time to give a comprehensive update to the splotch README file. It will improve the usability and (visual appearance) of the package, so I think we should follow the same guidelines, regardless of whether we decide further down the line to submit this package to pyOpenSci/JOSS. I also think it makes sense to combine this issue #30 for our next release.