danepitkin commented on PR #34894:
URL: https://github.com/apache/arrow/pull/34894#issuecomment-1507120380
> > If it's a doctest, we would need to replace `{}` with an equivalent like
`dict()` or `set()`. If it's part of the descriptions, it can be escaped e.g.
`{{}}`
>
> I think also in a doctest you can use the `{{ .. }}` escape approach?
>
> (and to be clear, the current PR doesn't run into that, right? It's only
for when we would want to use it more broadly for docstrings with examples?)
Correct! There are no uses of `{}` in the docstrings of this PR. You can
also use `{{ .. }}` for descriptions, but my guess is that doctests would fail
if you tried to use it in the code examples. I noticed Pandas usage always uses
`dict()` instead of `{{ .. }}` in code examples explicitly, but does use `{{ ..
}}` in the descriptions.
--
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]
