Docstrings

Documentation for every changed function, one click away. CloudAEye writes docstrings for undocumented code in an open pull request and posts them as review suggestions you can apply.

Suggested on the PR. Applied by you.

Generate docstrings for undocumented code in an open pull request and post them as review suggestions. Reports which suggestions were generated and which reached the PR.

GitHubacme/orders-api #412

On the pull request

src/billing/refund.pySuggested change
def apply_refund(order, amount):
    """Refund part or all of a paid order.

    Args:
        order: The paid order to refund.
        amount: The amount to refund, in the order's currency.

    Raises:
        ValueError: If amount exceeds the remaining balance.
    """    balance = order.total - order.refunded

Read it, then apply it with one click.

In your coding agent

/cloudaeye:add-docs #4129 docstrings proposed
File Suggestions
src/billing/refund.py 4
src/billing/invoice.py 3
src/billing/__init__.py 2

7 posted as one-click suggestions, 2 as comments.

Lines outside the PR's diff cannot take a suggestion, so those go up as plain comments. Both numbers are reported.

Documented before
the first review.

Undocumented functions are a reviewer's first comment. CloudAEye writes the docstrings for the code a pull request touches, and you decide what to apply.

In your repository's convention.

CloudAEye reads the code graph, not just the diff, to find changed functions and classes without a docstring, and writes each one in your repository's style.

  • FindsUndocumented changed code
  • WritesIn your repository's convention
  • PostsReview suggestions on the PR
See an example

Generated and posted, counted honestly.

The report shows how many docstrings were generated and how many reached the pull request, so nothing is rounded up.

  • In the diffOne-click suggestion
  • Outside the diffPlain comment
  • Nothing to addStill noted on the PR
Read the docs

You click apply.

Your coding agent confirms before posting, and the generated text stays on the pull request instead of passing through the agent's context.

  • Before postingAsks you to confirm
  • Generated textStays on the PR
  • Your working treeNever edited
See the commands

Fix failing docstring coverage.

Run it after the PR checklist reports docstring coverage failing, and close the gap without writing each docstring by hand.

  • Checklist saysDocstring coverage failed
  • Then run/cloudaeye:add-docs
  • ThenApply and re-check
Explore PR Hygiene

Commands

Claude Code
/cloudaeye:add-docs #412
Codex
$cloudaeye:add-docs #412
GitHub · Bitbucket · GitLab
@cloudaeye /add_docs