Skip to content

control-service: Data Jobs API documentation changes - #77

Merged
ivakoleva merged 7 commits into
mainfrom
person/ikoleva/api_docs_changes
Aug 18, 2021
Merged

control-service: Data Jobs API documentation changes#77
ivakoleva merged 7 commits into
mainfrom
person/ikoleva/api_docs_changes

Conversation

@ivakoleva

Copy link
Copy Markdown
Contributor

Documentation revised.

API license specified. API descriptions changes.
Data Job Development Lifecycle diagram added.

Testing Done: model generated; what needs to be verified is the relative image included is visualised properly (did consider including base64 directly, however it is quite some data to paste into docs).

An open question is, do we need to edit:
"sourceUrl": "https://github.com/product-analytics/data-jobs/tree/master/starshot-processing-vmc-fact-daily",

Documentation revised.

API license specified. API descriptions changes.
Data Job Development Lifecycle diagram added.

Testing Done: model generated

Signed-off-by: ikoleva <ikoleva@vmware.com>
doks5
doks5 previously requested changes Aug 12, 2021
Comment thread projects/control-service/projects/model/apidefs/datajob-api/api.yaml Outdated
Comment thread projects/control-service/projects/model/apidefs/datajob-api/api.yaml Outdated
Comment thread projects/control-service/projects/model/apidefs/datajob-api/api.yaml Outdated
Comment thread projects/control-service/projects/model/apidefs/datajob-api/api.yaml Outdated
Comment thread projects/control-service/projects/model/apidefs/datajob-api/api.yaml Outdated
Comment thread projects/control-service/projects/model/apidefs/datajob-api/api.yaml Outdated
Comment thread projects/control-service/projects/model/apidefs/datajob-api/api.yaml Outdated
Comment thread projects/control-service/projects/model/apidefs/datajob-api/api.yaml Outdated

@antoniivanov antoniivanov left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me.

My only issue is that I am not sure the Lifecycle.png image would render in swagger.

Comment thread projects/control-service/projects/model/apidefs/datajob-api/api.yaml Outdated
Comment thread projects/control-service/projects/model/apidefs/datajob-api/api.yaml Outdated
Comment thread projects/control-service/projects/model/apidefs/datajob-api/api.yaml Outdated
Comment thread projects/control-service/projects/model/apidefs/datajob-api/api.yaml Outdated
Comment thread projects/control-service/projects/model/apidefs/datajob-api/api.yaml Outdated
Comment thread projects/control-service/projects/model/apidefs/datajob-api/api.yaml Outdated
Comment thread projects/control-service/projects/model/apidefs/datajob-api/api.yaml Outdated
Documentation revised.

API license specified. API descriptions changes.
Data Job Development Lifecycle diagram added.

Testing Done: model generated

Signed-off-by: ikoleva <ikoleva@vmware.com>
Documentation revised.

API license specified. API descriptions changes.
Data Job Development Lifecycle diagram added.

Testing Done: model generated, control-service started locally
to verify Swagger docs

Signed-off-by: ikoleva <ikoleva@vmware.com>
Documentation revised.

API license specified. API descriptions changes.
Data Job Development Lifecycle diagram added.

Testing Done: model generated, control-service started locally
to verify Swagger docs

Signed-off-by: ikoleva <ikoleva@vmware.com>
Documentation revised. Data Jobs Deployment Lifecycle state diagram
added to the Wiki, and expected to be publicly accessible,
after publishing the project.

API license specified. API descriptions changes.
Data Job Development Lifecycle diagram added.

Testing Done: model generated, control-service started locally
to verify Swagger docs

Signed-off-by: ikoleva <ikoleva@vmware.com>
@ivakoleva
ivakoleva requested a review from doks5 August 18, 2021 13:20
@ivakoleva
ivakoleva dismissed doks5’s stale review August 18, 2021 13:22

Did agree to incremental changes with Dako Dakov

# Conflicts:
#	projects/control-service/projects/model/apidefs/datajob-api/api.yaml
@ivakoleva
ivakoleva enabled auto-merge (squash) August 18, 2021 14:20
@ivakoleva
ivakoleva merged commit d1dbb25 into main Aug 18, 2021
@ivakoleva
ivakoleva deleted the person/ikoleva/api_docs_changes branch August 18, 2021 14:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants