Doc: implement grpc properties as both parameter and attribute

[greschd]

In #265, we're adding a doc parameter to the grpc_data_property wrappers, to set the docstring on the properties. However, to avoid duplication of the docstring itself it's only set on read-only properties (where the same information doesn't need to be specified in the Parameters section of the __init__ docstring.

We should find a way to de-duplicate this information while still documenting it both on the property itself, and in the Parameters. Probably, the Parameters section can be auto-generated from the property docstrings.

[greschd]

To keep the assumptions on the existing docstring format minimal, maybe we can just place a marker like <doc-replace:parameter_name> into the docstring. The class decorator can search for this marker for each grpc property it knows about, and replace it.
Bonus points if the resulting docstring is wrapped and indented nicely.

[greschd]

Moving back to backlog since the approach from #273 does not work nicely.

[pyansys-automation]

Hello @greschd, @SRaimondi, @roosre!
This issue has been open for over a year and has had no updates in the past 8 months. If it is still relevant, please provide an update. Otherwise, consider closing it to help keep the issue tracker clean.

If this issue needs to remain open, please comment below with @pyansys-automation never close issue to prevent it from being automatically closed.

If you want this repository to be excluded from this automated maintenance process, please let us know by filling in the opt-out request form.

[greschd]

still relevant