Debulleting the Porch - Concepts pages#484
Open
lovesprung wants to merge 1 commit intonephio-project:mainfrom
Open
Debulleting the Porch - Concepts pages#484lovesprung wants to merge 1 commit intonephio-project:mainfrom
lovesprung wants to merge 1 commit intonephio-project:mainfrom
Conversation
✅ Deploy Preview for porch ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
dosubot
bot
added
size:L
lovesprung
requested review from
Catalin-Stratulat-Ericsson,
efiacor and
liamfallon
|
|
||
| * **Standard kpt packages** | ||
| Packages remain standard kpt packages. No vendor lock-in or Porch specific DSL "code" in kpt packages. | ||
| With Porch, you can manage packages through Kubernetes resources (PackageRevision, Repository) instead of direct Git operations. Use kubectl, client-go, or any Kubernetes tooling, or Porch's `porchctl` CLI utility. Packages move through lifecycle stages (Draft → Proposed → Published) with **approval workflows** and explicit approval gates, which helps prevent accidental publication of unreviewed changes. **Automatic package discovery** lets you register a Git or OCI repository once; Porch then discovers all packages in it, so there is no need for manual inventory management. **Function execution** applies KRM functions to transform and validate packages; functions run in isolated containers and their results are recorded in package history. **Package cloning and upgrades** let you clone packages from upstream sources and upgrade them automatically when new upstream versions are published, with a three-way merge preserving local customizations. **GitOps integration** means all changes are committed to Git with full history, and Porch works with [Flux](https://fluxcd.io/), [Config Sync](https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/installing-config-sync), and other GitOps deployment tools. **Multi-repository orchestration** lets you manage packages across multiple Git and OCI repositories from a single control plane, and controllers can automate cross-repository operations. **Collaboration and governance** allow multiple users and automation to work on packages at the same time, with draft revisions providing workspace isolation before publication. **Repository synchronization** lets Porch detect changes made directly in Git (outside Porch) and update its cache, and it supports both Porch-managed and externally-managed packages. Packages remain **standard kpt packages**, with no vendor lock-in or Porch-specific DSL in the kpt package content. |
Contributor
There was a problem hiding this comment.
i am a little concerned about this block in particular. i know we are "de-bulleting" but i think this one block pushes too much content into just one paragraph. i think it could do with a bit more segmentation in this instance.
reading all the "benefits/reasons to use porch" is far easier in segmented chunks than one big paragraph of this length.
The rest of the PR looks great.
Contributor
There was a problem hiding this comment.
bit of a question. why are we making bulletining the "Overview" section in the "Debulleting the Porch - Concepts pages" PR? should this not be in #485?
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Title
Debulleting the Porch - Concepts pages
Description
Minor rewrites to make the text more readable.
Type of Change
Checklist