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

pkg/schema, doc: improve doc for schema and bundle image reference #1933

Merged
merged 2 commits into from
Feb 25, 2022

Conversation

VinozzZ
Copy link
Contributor

@VinozzZ VinozzZ commented Feb 23, 2022

Signed-off-by: Yingrong Zhao [email protected]

What does this change

This PR improves porter's doc in two area:

  1. host porter's schema on porter.sh
  2. clarify image reference requirement

What issue does it fix

Closes #1908 and #1887

Notes for the reviewer

Checklist

  • Did you write tests?
  • Did you write documentation?
  • Did you change porter.yaml or a storage document record? Update the corresponding schema file.
  • If this is your first pull request, please add your name to the bottom of our Contributors list. Thank you for making Porter better! 🙇‍♀️

Reviewer Checklist

  • Comment with /azp run test-porter-release if a magefile or build script was modified
  • Comment with /azp run porter-integration if it's a non-trivial PR

@VinozzZ VinozzZ changed the title pkg/schema, doc: fix doc for schema and bundle image reference pkg/schema, doc: improve doc for schema and bundle image reference Feb 23, 2022
@@ -50,3 +50,8 @@
/:version/porter-darwin-amd64 https://github.com/getporter/porter/releases/download/:version/porter-darwin-amd64 302
/:version/porter-linux-amd64 https://github.com/getporter/porter/releases/download/:version/porter-linux-amd64 302
/:version/porter-windows-amd64.exe https://github.com/getporter/porter/releases/download/:version/porter-windows-amd64.exe 302

# Redirect the schema json files
/schema/v1/credential-set.schema.json https://raw.githubusercontent.com/getporter/porter/release/v1/pkg/schema/credential-set.schema.json
Copy link
Member

Choose a reason for hiding this comment

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

Instead of redirecting each file individually, let's take advantage of the netlify redirect tricks like * and :splat so that we can just have a single entry that will work for any schema file.

Also you will need to commit the change to the redirect file to the main branch too in order for netlify to use it with porter.sh.

@@ -1,5 +1,5 @@
{
"$id": "https://cnab.io/v1/credential-set.schema.json",
"$id": "https://porter.sh/schema/v1/credential-set.schema.json",
Copy link
Member

Choose a reason for hiding this comment

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

💯 Thanks for fixing this

Signed-off-by: Yingrong Zhao <[email protected]>
Copy link
Member

@carolynvs carolynvs left a comment

Choose a reason for hiding this comment

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

Thanks for fixing up the docs! 🙇‍♀️

@carolynvs carolynvs merged commit ecedc49 into getporter:release/v1 Feb 25, 2022
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.

2 participants