Skip to content
This repository has been archived by the owner on Jun 28, 2022. It is now read-only.

sample: add description for sample function #2290

Merged
merged 4 commits into from
Sep 6, 2018
Merged

sample: add description for sample function #2290

merged 4 commits into from
Sep 6, 2018

Conversation

pongad
Copy link
Contributor

@pongad pongad commented Sep 5, 2018

No description provided.

@codecov-io
Copy link

codecov-io commented Sep 5, 2018

Codecov Report

Merging #2290 into master will not change coverage.
The diff coverage is n/a.

Impacted file tree graph

@@            Coverage Diff            @@
##             master    #2290   +/-   ##
=========================================
  Coverage     86.75%   86.75%           
  Complexity     5134     5134           
=========================================
  Files           452      452           
  Lines         20400    20400           
  Branches       2190     2190           
=========================================
  Hits          17699    17699           
  Misses         1930     1930           
  Partials        771      771

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 307c852...5a381a6. Read the comment docs.

Copy link
Contributor

@vchudnov-g vchudnov-g left a comment

Choose a reason for hiding this comment

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

Two comments: one about spacing and the following one about the proto:

Could you expand the comment in the proto to indicate that description may appear in the sample? I suggest:

// A longer description for this set of values. This may be
  // used in the sample itself or in a UI element such as hoverbox.

@end

def sample_{@apiMethod.name}({@sampleFuncParam(sample.initCode.argDefaultParams)}):
""" {@sample.valueSet.description} """

This comment was marked as spam.

@pongad pongad merged commit c36da68 into googleapis:master Sep 6, 2018
@pongad pongad deleted the sample-func-desc branch September 6, 2018 22:44
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants