mirror of
https://github.com/PowerShell/PowerShell.git
synced 2024-11-23 01:34:19 +08:00
Fix failures in GitHub action markdown-link-check
(#20996)
This commit is contained in:
parent
c3eedde84c
commit
3dbd1c6c69
3
CHANGELOG/preview.md
Normal file
3
CHANGELOG/preview.md
Normal file
@ -0,0 +1,3 @@
|
||||
# Preview Changelog
|
||||
|
||||
Information about PowerShell previews will be found in this file
|
@ -13,9 +13,9 @@ git clone https://github.com/PowerShell/PowerShell.git --branch=master
|
||||
* Checkout a new local branch from `master` for every change you want to make (bugfix, feature).
|
||||
* Use lowercase-with-dashes for naming.
|
||||
* Follow [Linus' recommendations][Linus] about history.
|
||||
- "People can (and probably should) rebase their _private_ trees (their own work). That's a _cleanup_. But never other peoples code. That's a 'destroy history'...
|
||||
You must never EVER destroy other peoples history. You must not rebase commits other people did.
|
||||
Basically, if it doesn't have your sign-off on it, it's off limits: you can't rebase it, because it's not yours."
|
||||
* "People can (and probably should) rebase their _private_ trees (their own work). That's a _cleanup_. But never other peoples code. That's a 'destroy history'...
|
||||
You must never EVER destroy other peoples history. You must not rebase commits other people did.
|
||||
Basically, if it doesn't have your sign-off on it, it's off limits: you can't rebase it, because it's not yours."
|
||||
|
||||
### Understand branches
|
||||
|
||||
@ -23,12 +23,12 @@ git clone https://github.com/PowerShell/PowerShell.git --branch=master
|
||||
It could be unstable.
|
||||
* Send your pull requests to **master**.
|
||||
|
||||
### Sync your local repo
|
||||
### Sync your local repository
|
||||
|
||||
Use **git rebase** instead of **git merge** and **git pull**, when you're updating your feature-branch.
|
||||
|
||||
```sh
|
||||
# fetch updates all remote branch references in the repo
|
||||
# fetch updates all remote branch references in the repository
|
||||
# --all : tells it to do it for all remotes (handy, when you use your fork)
|
||||
# -p : tells it to remove obsolete remote branch references (when they are removed from remote)
|
||||
git fetch --all -p
|
||||
@ -42,9 +42,7 @@ git rebase origin/master
|
||||
Covering all possible git scenarios is behind the scope of the current document.
|
||||
Git has excellent documentation and lots of materials available online.
|
||||
|
||||
We are leaving few links here:
|
||||
|
||||
[Git pretty flowchart](http://justinhileman.info/article/git-pretty/): what to do, when your local repo became a mess.
|
||||
We are leaving a few links here:
|
||||
|
||||
[Linus]:https://wincent.com/wiki/git_rebase%3A_you're_doing_it_wrong
|
||||
|
||||
@ -57,12 +55,12 @@ you will find it via **tags**.
|
||||
* Find the tag that corresponds to the release.
|
||||
* Use `git checkout <tag-name>` to get this version.
|
||||
|
||||
**Note:** [checking out a tag][tag] will move the repo to a [DETACHED HEAD][HEAD] state.
|
||||
**Note:** [checking out a tag][tag] will move the repository to a [DETACHED HEAD][HEAD] state.
|
||||
|
||||
[tag]:https://git-scm.com/book/en/v2/Git-Basics-Tagging#Checking-out-Tags
|
||||
[HEAD]:https://www.git-tower.com/learn/git/faq/detached-head-when-checkout-commit
|
||||
|
||||
If you want to make changes, based on tag's version (i.e. a hotfix),
|
||||
If you want to make changes, based on tag's version (i.e. a hotfix),
|
||||
checkout a new branch from this DETACHED HEAD state.
|
||||
|
||||
```sh
|
||||
|
@ -21,20 +21,15 @@ This is to help track the release preparation work.
|
||||
- Sign the MSI packages and DEB/RPM packages.
|
||||
- Install and verify the packages.
|
||||
1. Update documentation, scripts and Dockerfiles
|
||||
- Summarize the change log for the release. It should be reviewed by PM(s) to make it more user-friendly.
|
||||
- Update [CHANGELOG.md](../../CHANGELOG.md) with the finalized change log draft.
|
||||
- Summarize the changelog for the release. It should be reviewed by PM(s) to make it more user-friendly.
|
||||
- Update [CHANGELOG.md](../../CHANGELOG.md) with the finalized changelog draft.
|
||||
- Update other documents and scripts to use the new package names and links.
|
||||
1. Verify the release Dockerfiles.
|
||||
1. [Create NuGet packages](#nuget-packages) and publish them to [powershell-core feed][ps-core-feed].
|
||||
1. [Create the release tag](#release-tag) and push the tag to `PowerShell/PowerShell` repository.
|
||||
1. Create the draft and publish the release in Github.
|
||||
1. Create the draft and publish the release in GitHub.
|
||||
1. Merge the `release-<Release Tag>` branch to `master` in `powershell/powershell` and delete the `release-<Release Tag>` branch.
|
||||
1. Publish Linux packages to Microsoft YUM/APT repositories.
|
||||
1. Trigger the release docker builds for Linux and Windows container images.
|
||||
- Linux: push a branch named `docker` to `powershell/powershell` repository to trigger the build at [powershell docker hub](https://hub.docker.com/r/microsoft/powershell/builds/).
|
||||
Delete the `docker` branch once the builds succeed.
|
||||
- Windows: queue a new build in `PowerShell Windows Docker Build` on VSTS.
|
||||
1. Verify the generated docker container images.
|
||||
1. [Update the homebrew formula](#homebrew) for the macOS package.
|
||||
This task usually will be taken care of by the community,
|
||||
so we can wait for one day or two and see if the homebrew formula has already been updated,
|
||||
@ -104,7 +99,7 @@ this package will contain actual PowerShell bits
|
||||
(i.e. it is not a meta-package).
|
||||
These bits are installed to `/opt/microsoft/powershell/6.0.0-alpha.8/`,
|
||||
where the version will change with each update
|
||||
(and is the pre-release version).
|
||||
(and is the prerelease version).
|
||||
On macOS, the prefix is `/usr/local`,
|
||||
instead of `/opt/microsoft` because it is derived from BSD.
|
||||
|
||||
@ -173,7 +168,7 @@ Start-PSPackage -Type zip -ReleaseTag v6.0.0-beta.1 -WindowsRuntime 'win7-x64'
|
||||
|
||||
## NuGet Packages
|
||||
|
||||
The NuGet packages for hosting PowerShell for Windows and non-Windows are being built in our release build pipeline.
|
||||
The NuGet packages for hosting PowerShell for Windows and non-Windows are being built-in our release build pipeline.
|
||||
The assemblies from the individual Windows and Linux builds are consumed and packed into NuGet packages.
|
||||
These are then released to [powershell-core feed][ps-core-feed].
|
||||
|
||||
@ -190,7 +185,7 @@ we create an [annotated tag][tag] that names the release.
|
||||
An annotated tag has a message (like a commit),
|
||||
and is *not* the same as a lightweight tag.
|
||||
Create one with `git tag -a v6.0.0-alpha.7 -m <message-here>`,
|
||||
and use the release change logs as the message.
|
||||
and use the release changelogs as the message.
|
||||
Our convention is to prepend the `v` to the semantic version.
|
||||
The summary (first line) of the annotated tag message should be the full release title,
|
||||
e.g. 'v6.0.0-alpha.7 release of PowerShellCore'.
|
||||
|
@ -3,7 +3,7 @@
|
||||
|
||||
This directory contains useful scripts and related files for analyzing PowerShell performance.
|
||||
|
||||
If you use the [Windows Performance Toolkit](https://developer.microsoft.com/en-US/windows/downloads/windows-10-sdk), you can use the following to collect data and analyze a trace.
|
||||
If you use the [Windows Performance Toolkit](https://learn.microsoft.com/windows-hardware/test/wpt/), you can use the following to collect data and analyze a trace.
|
||||
|
||||
```PowerShell
|
||||
$PowerShellGitRepo = "D:\PowerShell"
|
||||
|
Loading…
Reference in New Issue
Block a user