Skip to content
This repository was archived by the owner on May 28, 2021. It is now read-only.

WIP: OpenAPI Spec #216

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open

WIP: OpenAPI Spec #216

wants to merge 2 commits into from

Conversation

devdattakulkarni
Copy link

DO NOT MERGE

We analyzed types.go to check its adherence to OpenAPI format.

We found that it is violating OpenAPI Spec rules at certain
places. This patch fixes those violations by updating types.go.
After making the changes we were able to generate OpenAPI Spec correctly.

Included files:

  • kube-openapi-violations.txt: Output showing OpenAPI Spec violations
  • openapispec.json: Generated OpenAPI Spec

We used following tool to analyze and generate OpenAPI Spec:
https://github.com/cloud-ark/kubeplus/tree/master/openapi-spec-generator

The analysis was performed with the goal of checking the Operator against
these guidelines:

https://medium.com/@cloudark/kubernetes-operator-development-guidelines-for-improved-usability-222390b00dc4

DO NOT MERGE

We analyzed types.go to check its adherence to OpenAPI format.

We found that it is violating OpenAPI Spec rules at certain
places. This patch fixes those violations by updating types.go.
After making the changes we were able to generate OpenAPI Spec correctly.

Included files:
- kube-openapi-violations.txt: Output showing OpenAPI Spec violations
- openapispec.json: Generated OpenAPI Spec

We used following tool to analyze and generate OpenAPI Spec:
https://github.com/cloud-ark/kubeplus/tree/master/openapi-spec-generator

The analysis was performed with the goal of checking the Operator against
these guidelines:

https://medium.com/@cloudark/kubernetes-operator-development-guidelines-for-improved-usability-222390b00dc4
We analyzed types.go to check its adherence to OpenAPI format.

We found that it is violating OpenAPI Spec rules at certain
places. This patch fixes those violations by updating types.go.
After making the changes we were able to generate OpenAPI Spec correctly.

Included files:

kube-openapi-violations.txt: Output showing OpenAPI Spec violations
openapispec.json: Generated OpenAPI Spec
We used following tool to analyze and generate OpenAPI Spec:
https://github.com/cloud-ark/kubeplus/tree/master/openapi-spec-generator

The analysis was performed with the goal of checking the Operator against
these guidelines:

https://medium.com/@cloudark/kubernetes-operator-development-guidelines-for-improved-usability-222390b00dc4
@owainlewis owainlewis added the oracle-cla: no Contributor has not yet signed the Oracle Contributor Licence Agreement label Sep 6, 2018
@owainlewis
Copy link
Member

owainlewis commented Sep 6, 2018

Thanks for the contribution @devdattakulkarni we'll take a look at this over the next few days.

Once you're ready, would you mind rebasing your PR into a singe signed-off commit (for reference see here)? Also, if you're happy, would you mind signing the Oracle Contributor Agreement?

@devdattakulkarni
Copy link
Author

@owainlewis 👍
Will look forward to the feedback from your team.

Also, I will be happy to squash all the changes in a single commit and sign the contributor agreement before re-submitting.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
oracle-cla: no Contributor has not yet signed the Oracle Contributor Licence Agreement
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants