-
Notifications
You must be signed in to change notification settings - Fork 1.5k
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
Conversation
|
||
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.
Sorry, something went wrong.
This comment was marked as spam.
This comment was marked as spam.
Sorry, something went wrong.
fa6429b
to
51c7b41
Compare
@@ -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.
This comment was marked as spam.
Sorry, something went wrong.
@tseaver PTAL I added |
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 |
Gotcher. In |
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`
51c7b41
to
c684c29
Compare
Fixing some docstrings that did not render as intended
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
dict
instead ofdictionary
,bool
instead ofboolean
) since Sphinx recognizes them.