Add type annotations & improve openshift-docs-downloader.py

- Add proper type annotations to all functions
- Fix Optional parameter handling
- Fix Path-related type errors
- Rewrite rate limiting implementation to avoid method assignment issues
- Fix logic issue in is_in_scope function
- Update docstrings with consistent formatting
- Enhance async file operations to use safer methods

Author: max-svistunov