Updated gen_popular_issues.py to provide information on failure

[dameikle]

This pull request refactors and improves error handling and logging in the docs/scripts/gen_popular_issues.py script. The changes include introducing a reusable empty DataFrame, adding detailed logging for debugging, and ensuring graceful handling of edge cases such as missing or filtered data.

Refactoring and code reuse:

• Introduced a constant EMPTY_FRAME to represent an empty DataFrame, replacing inline DataFrame creation for better reusability and readability. [1] [2]

Enhanced logging and debugging:

• Added logging to display the number of issues fetched in each batch, the total number of issues processed, and the number of issues filtered out. [1] [2]
• Included warnings and detailed DataFrame information when the State column is missing, to aid in diagnosing issues with the data.

Improved error handling:

• Ensured the function returns EMPTY_FRAME when no issues data is collected, avoiding potential errors downstream.

[codspeed-hq]

CodSpeed Performance Report

Merging #1145 will improve performances by ×24

_{Comparing docs_popular_issues_failures (71d7033) with develop (6dd63f8)}

Summary

⚡ 1 improvements

Benchmarks breakdown

	Benchmark	BASE	HEAD	Change
⚡	test_cache_time	15,826.7 ms	670.8 ms	×24

[github-actions]

Documentation for this PR has been built. You can view it at: https://distilabel.argilla.io/pr-1145/