aws-cloudformation / aws-cloudformation/cloudformation-cli-python-plugin
Improve docstrings for Hooks
- 主要语言
- Python
- 星标
- 107
- 派生
- 46
- PR 合并指标
- 30 天内没有已合并 PR
描述
Hi there :wave:,
It would be nice to have Python docstrings included on the public interfaces when developing hooks.
Would pull requests for docstrings be welcome?
For example, after `cfn init` for hooks, we have a `../handlers.py` that looks similar to this:

In Visual Studio Code, when I hover over `cloudformation_cli_python_lib` specific classes/properties I don't get any information for what they are, or what to expect.
I couldn't find out what all the `request.hookContext` properties mean, and what `dict` keys are available on `request.hookContext.targetModel` from the [Implement Hook handlers (Python)](https://docs.aws.amazon.com/cloudformation-cli/latest/hooks-userguide/hooks-model.html#model-hook-project-code-handler-python) documentation.
In the case of `HookContext` some docstrings like this would be welcome:

Cheers,
Neil
贡献指南
评估
这个 Issue 还没有评估数据。