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

update the description of uri to make it more clear #387

Merged
merged 3 commits into from
May 4, 2021

Conversation

yangcao77
Copy link
Contributor

@yangcao77 yangcao77 commented Mar 23, 2021

Signed-off-by: Stephanie [email protected]

What does this PR do?

This PR updates the description of uri reference to make it more clear on the supported usage

What issues does this PR fix or reference?

Fixes #386

Is your PR tested? Consider putting some instruction how to test your changes

Docs PR

@maysunfaisal
Copy link
Member

@yangcao77 I would also add desc to RegistryUrl while you're at it with this PR, it currently does not have any desc

Copy link
Contributor

@elsony elsony left a comment

Choose a reason for hiding this comment

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

In general, change all "Uri" to "URI" in all descriptions and comments (not including the fields).

@@ -21,7 +21,8 @@ type ImportReferenceUnion struct {
// +optional
ImportReferenceType ImportReferenceType `json:"importReferenceType,omitempty"`

// Uri of a Devfile yaml file
// Uri Reference of a Devfile yaml file, can be an absolute http URL address
// or a relative Uri with the current devfile as the base Uri
Copy link
Contributor

Choose a reason for hiding this comment

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

Change Uri to URI in the comment

Copy link
Contributor

@elsony elsony left a comment

Choose a reason for hiding this comment

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

/lgtm

@openshift-ci-robot
Copy link

@yangcao77: PR needs rebase.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

@@ -5499,9 +5499,17 @@ spec:
- name
type: object
registryUrl:
description: Registry URL to pull devfile from with
Copy link
Contributor

Choose a reason for hiding this comment

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

Consider changing to:
"Registry URL to pull the parent devfile from when using id in the parent reference. To ensure the parent devfile gets resolved consistently in different environments, it is recommended to always specify the regsitryURL when id is used."
(with registryURL and id` properly formated)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

updated

type: string
uri:
description: Uri of a Devfile yaml file
description: URI Reference of a Devfile yaml file, can
Copy link
Contributor

Choose a reason for hiding this comment

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

Consider changing to:
"URI Reference of a parent devfile YAML file. It can be a full URL or a relative URI with the current devfile as the base URI."

Copy link
Contributor Author

Choose a reason for hiding this comment

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

updated

Copy link
Contributor

@elsony elsony left a comment

Choose a reason for hiding this comment

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

/lgtm

@openshift-ci-robot
Copy link

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: amisevsk, elsony, yangcao77

The full list of commands accepted by this bot can be found here.

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@yangcao77 yangcao77 merged commit 37a9d1e into devfile:main May 4, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

registryURL should a valid URL not just hostname
5 participants