Skip to content
This repository was archived by the owner on Jul 13, 2025. It is now read-only.

Ruby documentation fixes#1549

Merged
geigerj merged 3 commits intogoogleapis:masterfrom
geigerj:ruby-doc-fixes
Sep 11, 2017
Merged

Ruby documentation fixes#1549
geigerj merged 3 commits intogoogleapis:masterfrom
geigerj:ruby-doc-fixes

Conversation

@geigerj
Copy link
Copy Markdown
Contributor

@geigerj geigerj commented Sep 8, 2017

Based on feedback from
googleapis/google-cloud-ruby#1702

  • Use @overload to prevent YARD from being confused when @param docs
    do not match the *args, **kwargs method signature
  • Do not use *args, **kwargs when the true method signature is known
  • End version index files in newline, per convention

Based on feedback from
  googleapis/google-cloud-ruby#1702

- Use "@overload" to prevent YARD from being confused when @param docs
  do not match the *args, **kwargs method signature
- Do not use *args, **kwargs when the true method signature is known
- End version index files in newline, per convention
@geigerj geigerj requested review from evaogbe and landrito September 8, 2017 20:38
@codecov-io
Copy link
Copy Markdown

codecov-io commented Sep 8, 2017

Codecov Report

Merging #1549 into master will increase coverage by <.01%.
The diff coverage is 100%.

Impacted file tree graph

@@             Coverage Diff              @@
##             master    #1549      +/-   ##
============================================
+ Coverage     87.04%   87.04%   +<.01%     
- Complexity     4205     4207       +2     
============================================
  Files           408      408              
  Lines         16866    16868       +2     
  Branches       1832     1832              
============================================
+ Hits          14681    14683       +2     
  Misses         1695     1695              
  Partials        490      490
Impacted Files Coverage Δ Complexity Δ
...m/google/api/codegen/util/CommonRenderingUtil.java 79.41% <100%> (+1.28%) 18 <2> (+2) ⬆️

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update cff2a1c...c4dd54b. Read the comment docs.

Copy link
Copy Markdown
Contributor

@landrito landrito left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM one nit.

# @param timeout [Numeric]
# The default timeout, in seconds, for calls made through this client.
# @overload
# @param version [Symbol, String]

This comment was marked as spam.

This comment was marked as spam.

- Move `version` param out of `@overload` section
@geigerj geigerj merged commit e2f915a into googleapis:master Sep 11, 2017
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants