Documentation and type hinting validation for utils-ts compliant utils-py functionality

[aorumbayev]

Description

The goal is to ensure clear and cohesive documentation that mirrors the structure of utils-ts docs. Additionally, validating type hinting on new AlgorandClient based abstractions, as well as ensuring deprecation notes on all legacy stateless functions that were available before.

Technical Details

Acceptance Criteria

• algokit-utils-py documentation are up-to-date, high level structure matches docs of latest algokit-utils-ts.
• Type hinting allows intuitive usage of the package
• Legacy methods provide convenient and granular guides on how to update to latest recommended usage

[aorumbayev]

Implemented as part of #119 and follow up beta patch PRs. Outcome itself is to be closed after prod release of utils-v3