I first came across File::ShareDir about five or so years ago. Like you, I found the esoteric "little-known method" description unhelpful and confusing.

I've used it in conjunction with File::ShareDir::Install. I've only used the simplest case (as described in the SYNOPSIS): I found it straightforward, easy to use, and haven't encountered any problems with it.