Sort diagram figures before writing its table documentation

[JPPinto]

If for some reason a figure is removed from the diagram, the documentation will be arranged in insertion order and not in alphabetic one.

I think this could be a good enhancement and relatively easy to implement.