Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fixing some docstrings that did not render as intended #1345

Merged
merged 1 commit into from
Jan 7, 2016

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

Checks environment in order of precedence:

* Google App Engine (production and testing)
* Environment variable GOOGLE_APPLICATION_CREDENTIALS pointing to
* Environment variable ``GOOGLE_APPLICATION_CREDENTIALS`` pointing to

This comment was marked as spam.

This comment was marked as spam.

@@ -12,7 +12,7 @@
# See the License for the specific language governing permissions and
# limitations under the License.

"""Custom exceptions for gcloud.storage package.
"""Custom exceptions for :mod:`gcloud` package.

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 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.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants