Suggested fix for ticket 21223 (Documentation improvement)

Suggested fix for ticket 21223, as discussed with @evildmp Pycon Ireland Sprints.