-
Notifications
You must be signed in to change notification settings - Fork 80
feat(batches): add docs for pushed-only changesets #1200
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
Changes from all commits
93a6c27
4b05e01
3ca27fe
8cde82e
0ea6575
034b452
f0b007b
3906a23
8bde0f2
7c8e8ea
7853aa7
6a06661
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,30 @@ | ||
| # Pushing code to a code host | ||
|
|
||
| <p className="subtitle">Learn how to push code changes to a code host without making a merge request.</p> | ||
|
|
||
| <Callout type="note">Pushed-only changesets work on GitHub and GitLab only. They do not yet work with forked repositories.</Callout> | ||
|
|
||
| After you've [created a batch change](/batch-changes/create-a-batch-change), you will be redirected to a page displaying a list of the changesets the Batch Change created. From this page, you can apply any bulk operation to more than one changesets. | ||
|
|
||
| To push code to a new branch on a code host without also creating a merge request, simply select **Push to code host only** from the dropdown menu: | ||
|
|
||
|  | ||
|
|
||
| ## Few important considerations | ||
|
|
||
| - With pushed-only changesets, you are still able see CI feedback, as long as it triggers on code pushes | ||
| - The `review` status of a pushed-only changeset is always "N/A" | ||
| - The `status` of a pushed-only changeset is always "Open" | ||
| - To publish a pushed-only changeset, simply select the changeset in the Batch Changes UI and select **Publish** | ||
|
|
||
|  | ||
|
|
||
| ## Requirements | ||
|
|
||
| To push code to a new branch on a code host, you will need: | ||
|
|
||
| - [Admin permissions for the batch change](/batch-changes/permissions-in-batch-changes#permission-levels-for-batch-changes) | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Is this on Sourcegraph's or GitHub's side?
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Ah, I see write access to the code host mentioned below. Does it make sense to call it site-admin here? |
||
| - Write access to the changeset's repository on the code host | ||
| - [Credentials](/batch-changes/configuring-credentials) configured for the code host | ||
|
|
||
| <Callout type="note">For more information, see [Code host interactions in Batch Changes](/batch-changes/permissions-in-batch-changes#code-host-interactions-in-batch-changes).</Callout> | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -152,8 +152,10 @@ export const navigation: NavigationItem[] = [ | |
| title: "Bulk Operations", href: "/batch-changes/bulk-operations-on-changesets", | ||
| subsections: [ | ||
| { title: "Publishing Changesets", href: "/batch-changes/publishing-changesets", }, | ||
| { title: "Pushing Code", href: "/batch-changes/push-only-changesets", }, | ||
| { title: "Tracking Changesets", href: "/batch-changes/tracking-existing-changesets", }, | ||
| { title: "Rebasing Changesets", href: "/batch-changes/rebasing-changesets", }, | ||
|
|
||
| ] | ||
| }, | ||
| { | ||
|
|
@@ -164,7 +166,7 @@ export const navigation: NavigationItem[] = [ | |
| }, | ||
| { title: "Access Permissions", href: "/batch-changes/permissions-in-batch-changes" }, | ||
| { | ||
| title: "Changesets in Monorepo", href: "/batch-changes/creating-changesets-per-project-in-monorepos", | ||
| title: "Changesets in Monorepos", href: "/batch-changes/creating-changesets-per-project-in-monorepos", | ||
|
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Quick nit (unrelated to core PR) |
||
| subsections: [ | ||
| { title: "Changesets in Large Repos", href: "/batch-changes/creating-multiple-changesets-in-large-repositories", }, | ||
| ] | ||
|
|
@@ -187,7 +189,7 @@ export const navigation: NavigationItem[] = [ | |
| ] | ||
| }, | ||
| { | ||
| title: "Working with CLI", href: "/batch-changes/how-src-executes-a-batch-spec", | ||
| title: "Working with the CLI", href: "/batch-changes/how-src-executes-a-batch-spec", | ||
|
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Quick nit (unrelated to core PR) |
||
| subsections: [ | ||
| { title: "Re-executing Batch Specs", href: "/batch-changes/reexecuting-batch-specs-multiple-times", }, | ||
| { title: "CLI Subcommands", href: "/cli/references/batch", }, | ||
|
|
||
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.
Note: the bulk operation is called "push" only (verb is active), whereas the non-bulk-op (not documented in this PR) and the reference to the state of the changeset is "pushED" only (e.g. "Look at this pushed-only changeset I made").