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

feat: add docs params to proxy and mesh resources #4132

Conversation

bartsmykla
Copy link
Contributor

Summary

Proxy resources like Dataplane, ZoneIngress and ZoneEgress,
as well as Mesh api resources are now marked with doc params,
which will allow us to generate the reference docs automatically.

Blocked by: kumahq/protoc-gen-kumadoc#8 and pushing 0.2.0 tag for protoc-gen-kumadoc after the PR will be merged

Full changelog

n/a

Issues resolved

n/a

Documentation

n/a

Testing

  • Unit tests
  • E2E tests
  • Manual testing on Universal
  • Manual testing on Kubernetes

Backwards compatibility

  • Update UPGRADE.md with any steps users will need to take when upgrading.
  • Add backport-to-stable label if the code follows our backporting policy

Proxy resources like `Dataplane`, `ZoneIngress` and `ZoneEgress`,
as well as `Mesh` api resources are now marked with doc params,
which will allow us to generate the reference docs automatically.

Signed-off-by: Bart Smykla <bartek@smykla.com>
@bartsmykla bartsmykla requested a review from a team as a code owner April 6, 2022 06:05
Signed-off-by: Bart Smykla <bartek@smykla.com>
Signed-off-by: Bart Smykla <bartek@smykla.com>
Signed-off-by: Bart Smykla <bartek@smykla.com>
api/mesh/v1alpha1/dataplane.proto Outdated Show resolved Hide resolved
api/mesh/v1alpha1/dataplane.proto Outdated Show resolved Hide resolved
api/mesh/v1alpha1/dataplane.proto Outdated Show resolved Hide resolved
api/mesh/v1alpha1/dataplane.proto Outdated Show resolved Hide resolved
api/mesh/v1alpha1/mesh.proto Outdated Show resolved Hide resolved
api/mesh/v1alpha1/mesh.proto Outdated Show resolved Hide resolved
api/mesh/v1alpha1/mesh.proto Outdated Show resolved Hide resolved
api/mesh/v1alpha1/mesh.proto Outdated Show resolved Hide resolved
api/mesh/v1alpha1/zone_ingress.proto Show resolved Hide resolved
api/mesh/v1alpha1/zone_ingress.proto Show resolved Hide resolved
Signed-off-by: Bart Smykla <bartek@smykla.com>
Signed-off-by: Bart Smykla <bartek@smykla.com>
Signed-off-by: Bart Smykla <bartek@smykla.com>
@bartsmykla bartsmykla enabled auto-merge (squash) April 7, 2022 08:50
@bartsmykla bartsmykla merged commit 4a134f7 into kumahq:master Apr 7, 2022
SallyBlichWalkMe pushed a commit to SallyBlichWalkMe/kuma that referenced this pull request Apr 20, 2022
* feat: add docs params to proxy and mesh resources

Proxy resources like `Dataplane`, `ZoneIngress` and `ZoneEgress`,
as well as `Mesh` api resources are now marked with doc params,
which will allow us to generate the reference docs automatically.

Signed-off-by: Bart Smykla <bartek@smykla.com>
SallyBlichWalkMe pushed a commit to SallyBlichWalkMe/kuma that referenced this pull request Apr 21, 2022
* feat: add docs params to proxy and mesh resources

Proxy resources like `Dataplane`, `ZoneIngress` and `ZoneEgress`,
as well as `Mesh` api resources are now marked with doc params,
which will allow us to generate the reference docs automatically.

Signed-off-by: Bart Smykla <bartek@smykla.com>
SallyBlichWalkMe pushed a commit to SallyBlichWalkMe/kuma that referenced this pull request Apr 21, 2022
* feat: add docs params to proxy and mesh resources

Proxy resources like `Dataplane`, `ZoneIngress` and `ZoneEgress`,
as well as `Mesh` api resources are now marked with doc params,
which will allow us to generate the reference docs automatically.

Signed-off-by: Bart Smykla <bartek@smykla.com>
Signed-off-by: Sally Blich <sally.blich@walkme.com>
SallyBlichWalkMe pushed a commit to SallyBlichWalkMe/kuma that referenced this pull request Apr 21, 2022
* feat: add docs params to proxy and mesh resources

Proxy resources like `Dataplane`, `ZoneIngress` and `ZoneEgress`,
as well as `Mesh` api resources are now marked with doc params,
which will allow us to generate the reference docs automatically.

Signed-off-by: Bart Smykla <bartek@smykla.com>
Signed-off-by: Sally Blich <sally.blich@walkme.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants