docs: publish troubleshooting guide += Did you forget "provides"?

Based on a true story.

Reviewed at https://rbcommons.com/s/twitter/r/352/