in #121 we added documentation suggesting that docstring sections should be in specified order. This should be augmented with a warning when the sections are out of order. This was the consensus at #68.