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鈥檒l occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix: improve docs #77

Merged
merged 19 commits into from Oct 27, 2020
Merged

fix: improve docs #77

merged 19 commits into from Oct 27, 2020

Conversation

daniel-sanche
Copy link
Contributor

@daniel-sanche daniel-sanche commented Oct 19, 2020

Problem:
The generated docs on googleapis.dev are miseading. They advertise two versions of the API, when we actually only publish v2. It also makes it seem like the autogenerated library is the newer version and the handwritten layer is deprecated

This PR:

  • removed the autogenerated layer from the generated documentation at googleapis.dev
  • removed the misleading v1 version from googleapis.dev
  • improved the code samples on the README to use the hand-written layer instead of autogenerated code
  • changed branding in the docs from Stackdriver Logging to Cloud Logging and Container Engine to Kubernetes Engine
  • got the Kokoro docs-presubmit check to turn green

This should greatly reduce customer confusion

Fixes ##76 馃

@google-cla google-cla bot added the cla: yes label Oct 19, 2020
@daniel-sanche daniel-sanche marked this pull request as ready for review Oct 20, 2020
@daniel-sanche daniel-sanche requested a review from as a code owner Oct 20, 2020
@simonz130 simonz130 added type: docs api: logging lang: python labels Oct 26, 2020
CHANGELOG.md Outdated Show resolved Hide resolved
README.rst Outdated Show resolved Hide resolved
@daniel-sanche daniel-sanche requested a review from as a code owner Oct 27, 2020
@daniel-sanche daniel-sanche requested a review from busunkim96 Oct 27, 2020
@daniel-sanche daniel-sanche merged commit bdd9c44 into googleapis:master Oct 27, 2020
9 checks passed
gcf-merge-on-green bot pushed a commit that referenced this issue Nov 19, 2020
馃 I have created a release \*beep\* \*boop\* 
---
## [2.0.0](https://www.github.com/googleapis/python-logging/compare/v1.15.1...v2.0.0) (2020-11-19)


###  BREAKING CHANGES

* Use microgenerator for GAPIC layer. See [UPGRADING.md](https://github.com/googleapis/python-logging/blob/master/UPGRADING.md) for details. (#94)
* removes support for webapp2 and other Python2 specific code

### Features

* pass 'client_options' to super ctor ([#61](https://www.github.com/googleapis/python-logging/issues/61)) ([c4387b3](https://www.github.com/googleapis/python-logging/commit/c4387b307f8f3502fb53ae1f7e1144f6284280a4)), closes [#55](https://www.github.com/googleapis/python-logging/issues/55)
* use microgenerator ([#94](https://www.github.com/googleapis/python-logging/issues/94)) ([ff90fd2](https://www.github.com/googleapis/python-logging/commit/ff90fd2fb54c612fe6ab29708a2d5d984f60dea7))


### Bug Fixes

* add default filter settings to list_entries ([#73](https://www.github.com/googleapis/python-logging/issues/73)) ([0a1dd94](https://www.github.com/googleapis/python-logging/commit/0a1dd94811232634fdb849cb2c85bd44e870642f))
* failing CI tests ([#70](https://www.github.com/googleapis/python-logging/issues/70)) ([96adeed](https://www.github.com/googleapis/python-logging/commit/96adeedbda16a5c21651c356261442478aaa867a))


### Code Refactoring

* remove python2 ([#78](https://www.github.com/googleapis/python-logging/issues/78)) ([bf579e4](https://www.github.com/googleapis/python-logging/commit/bf579e4f871c92391a9f6f87eca931744158e31a))


### Documentation

* update docs ([#77](https://www.github.com/googleapis/python-logging/issues/77)) ([bdd9c44](https://www.github.com/googleapis/python-logging/commit/bdd9c440f29d1fcd6fb9545d8465c63efa6c0cea))
---


This PR was generated with [Release Please](https://github.com/googleapis/release-please).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
api: logging cla: yes lang: python type: docs
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants