Skip to content

Conversation

@signedav
Copy link
Member

@signedav signedav commented Nov 18, 2025

  • Concert headers to preferred Google style
  • Convert existing ReSt Docstrings to Google style
  • Complete type hints. Resolves Complete type hints #99
    If time left
  • Generate docstrings templates according to type hints with AI
  • Fill up docstrings templates manually

@signedav signedav changed the title Docstring Not yet the docstrings, but the base before we create docstrings Nov 28, 2025
@signedav
Copy link
Member Author

My goal was to invest a day in documentation of the library, like with docstrings etc. But in the end the docstrings are massively easier to generate when there are already proper typehints. And for working with the library they are at least as valuable. So these are at least the typehints of all the functions.

Header format in proper py docsting style

Header docstring in proper format

headers of processing
Type hints for iliwrapper

Typehints for generator

Type hints for utils

Type hints for ilitoppingmaker
@signedav signedav changed the title Not yet the docstrings, but the base before we create docstrings Typehints etc: Not yet the docstrings, but the base to create docstrings Nov 28, 2025
@signedav signedav marked this pull request as ready for review November 28, 2025 16:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Complete type hints

2 participants