I try to make using WWW::Mechanize::Firefox easy. Please tell me what you found unusable about the
WWW::Mechanize::Firefox documentation, and especially
WWW::Mechabize::Firefox::Examples and
WWW::Mechanize::Firefox::Troubleshooting. They get distributed with the module itself. Searching for
www::mechanize::firefox examples also returns that document on CPAN as the first hit to me, so if you tell me what search engine you used, or why you disregarded that result, I can use that information to improve the documentation.