Skip to content

Conversation

@dhermes
Copy link
Contributor

@dhermes dhermes commented Jan 4, 2016

Sphinx successfully rendered some docstrings that did things
different than intended. Found via visual inspection of a few
of the rendered files (more to come). Also

  • using names of basic types (dict instead of dictionary,
    bool instead of boolean) since Sphinx recognizes them.
  • fixing some broken Sphinx links
  • fixing some broken URLs (404, docs moved)
  • adding formatting to unformatted text
  • renaming doc with underscores to use hyphen
  • removing an accidentally public var that was documented (eklass -> _eklass)
@dhermes dhermes added the docs label Jan 4, 2016
@googlebot googlebot added the cla: yes This human has signed the Contributor License Agreement. label Jan 4, 2016
@dhermes dhermes mentioned this pull request Jan 6, 2016

This comment was marked as spam.

This comment was marked as spam.

@dhermes dhermes force-pushed the some-docs-cleanup branch from fa6429b to 51c7b41 Compare January 7, 2016 21:35

This comment was marked as spam.

@dhermes
Copy link
Contributor Author

dhermes commented Jan 7, 2016

@tseaver PTAL I added :envvar: and rebased

@tseaver
Copy link
Contributor

tseaver commented Jan 7, 2016

While I understand the desire for "pretty" history, this PR is a case where rebasing to squash commits interferes with review: the small changes you just introduced would've been easier to re-review as separate commits.

LGTM

@dhermes
Copy link
Contributor Author

dhermes commented Jan 7, 2016

Gotcher. In oauth2client, the maintainers usually ask for squashing after the fact. I should/can/will start doing that in PRs.

Sphinx successfully rendered some docstrings that did things different than intended. Found via visual inspection of a few of the rendered files (more to come). Also - using names of basic types (`dict` instead of `dictionary`, `bool` instead of `boolean`) since Sphinx recognizes them. - fixing some broken Sphinx links - fixing some broken URLs (404, docs moved) - adding formatting to unformatted text - renaming doc with underscores to use hyphen - removing an accidentally public var that was documented (eklass -> _eklass) - referring to `gcloud` module instead of `gcloud.storage` in `gcloud.exceptions`
@dhermes dhermes force-pushed the some-docs-cleanup branch from 51c7b41 to c684c29 Compare January 7, 2016 22:59
dhermes added a commit that referenced this pull request Jan 7, 2016
Fixing some docstrings that did not render as intended
@dhermes dhermes merged commit 5fc0150 into googleapis:master Jan 7, 2016
@dhermes dhermes deleted the some-docs-cleanup branch January 7, 2016 23:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla: yes This human has signed the Contributor License Agreement.

3 participants