-
Notifications
You must be signed in to change notification settings - Fork 112
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
Readme reorganize #669
Readme reorganize #669
Conversation
4a3c3ae
to
93bec76
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Just some things where I think we should change it a bit.
827f445
to
77e1987
Compare
Drives users on how to use Kaniko for building a container image.
Remove a Try It! section for buildstrategies docs, not longer needed. We have now a single Try It! in the main README
Doc that explains how to interact with the buildpacks stratey in order to build a container image.
62d1236
to
67d5fdb
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This looks great! I have some style nits and suggestions, but overall nothing serious or structural.
Nice work! 🎉
apiVersion: shipwright.io/v1alpha1 | ||
kind: BuildRun | ||
metadata: | ||
name: ruby-tutorial-buildrun |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
name: ruby-tutorial-buildrun | |
generateName: ruby-tutorial-buildrun- |
apiVersion: shipwright.io/v1alpha1 | ||
kind: BuildRun | ||
metadata: | ||
name: go-tutorial-buildrun |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
name: go-tutorial-buildrun | |
generateName: go-tutorial-buildrun- |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This was on purpose, otherwise it complicates the usage of kubectl get buildrun go-tutorial-buildrun -o json | jq '.status.conditions[]'
command.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Couple more
docs/tutorials/tutorial.md
Outdated
| **`Strategy`** | Refers to a particular tool that will be used when building a container image, such as Kaniko, Buildah, ko, etc. | | ||
| **`Build`** | Resource used to define a build configuration. | | ||
| **`BuildRun`** | Resource used to start the image build mechanism. | | ||
| **`BuildStrategy/ClusterBuildStrategy`** | Resource that holds a template that dictates how to build via a particular strategy. | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| **`BuildStrategy/ClusterBuildStrategy`** | Resource that holds a template that dictates how to build via a particular strategy. | | |
| **`BuildStrategy/ClusterBuildStrategy`** | Resource that holds a template that describes how to build via a particular strategy. | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nice rework. Some suggestions / corrections.
Co-authored-by: Jason Hall <[email protected]> Co-authored-by: Matthias Diester <[email protected]> Co-authored-by: Sascha Schwarze <[email protected]>
Co-authored-by: Jason Hall <[email protected]>
e85ab74
to
81bd4ab
Compare
0585fa4
to
5f1c042
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks good.
/approve |
Rename tutorial.md to README.md When listing strategies, follow an order of prio, based on Other minor enhance around versions.
5f1c042
to
7688e4f
Compare
[APPROVALNOTIFIER] This PR is APPROVED This pull-request has been approved by: SaschaSchwarze0 The full list of commands accepted by this bot can be found here. The pull request process is described here
Needs approval from an approver in each of these files:
Approvers can indicate their approval by writing |
/lgtm |
Changes
Fixes #655
Note: Opening this PR for feedback on the ongoing efforts to improve our README and to understand what other issues we might require to make this ready. The current state of this PR is:
Shipwright - a framework for building container images on Kubernetes
intoShipwright
Why?
section.Try It!
section. @zhangtbj you can take some ideas of this one and leverage your current PR.Please tell me more!
section. This one still incomplete. We will require new documents to properly provide more information for users that already try it, and that are looking forward to understand what else they can do. For example, how to build with Kaniko, or other strategies.More information
section. This one still incomplete. Here we want to add all existing information around dependencies, existing documentation links, etc. We assume that a user that is at this block, might be willing to contribute eventually, therefore the need of providing as much context as possible before jumping into contributions or similar.Want to get involved?
section. This one is only reusing the existing information we have already in this file.Submitter Checklist
See the contributor guide
for details on coding conventions, github and prow interactions, and the code review process.
Release Notes