* Illustrative usage first with all variables
* Example after description
* Refer to those variables in the docs rather than "the argument"
Link to the pop/shift documentation.
I also didn't think it's necessary to explain that pop changes the
@array. Maybe that's a bad assumption?