himanshuchawla0807-gif commented on PR #76701:
URL: https://github.com/apache/airflow/pull/76701#issuecomment-6718848759
An empty Sphinx field can now suppress the Google-style fallback entirely.
On bd208da, the following returns `{}`; the parent returns `{"path": "Path to
read."}`:
```python
doc = "Read records.\n\nArgs:\n path: Path to read.\n\n:param
undocumented:"
assert _parse_param_docs(doc) == {"path": "Path to read."}
```
The final line creates an entry in `params`, but the Sphinx return
expression filters that entry out after the decision to skip fallback.
Filtering empty descriptions before the `if params` decision restores the
Google description and passes all five existing parser cases. I ran the exact
parser function and test methods from Git in an isolated Python harness. Codex
generated and ran this check.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
