-
Notifications
You must be signed in to change notification settings - Fork 16
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #112 from AArnott/dev/andarno/libtemplateUpdate
Merge latest Library.Template
- Loading branch information
Showing
5 changed files
with
79 additions
and
3 deletions.
There are no files selected for viewing
This file contains 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
This file contains 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
This file contains 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
This file contains 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
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,74 @@ | ||
# Contributing | ||
|
||
This project has adopted the [Microsoft Open Source Code of | ||
Conduct](https://opensource.microsoft.com/codeofconduct/). | ||
For more information see the [Code of Conduct | ||
FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or | ||
contact [[email protected]](mailto:[email protected]) | ||
with any additional questions or comments. | ||
|
||
## Best practices | ||
|
||
* Use Windows PowerShell or [PowerShell Core][pwsh] (including on Linux/OSX) to run .ps1 scripts. | ||
Some scripts set environment variables to help you, but they are only retained if you use PowerShell as your shell. | ||
|
||
## Prerequisites | ||
|
||
All dependencies can be installed by running the `init.ps1` script at the root of the repository | ||
using Windows PowerShell or [PowerShell Core][pwsh] (on any OS). | ||
Some dependencies installed by `init.ps1` may only be discoverable from the same command line environment the init script was run from due to environment variables, so be sure to launch Visual Studio or build the repo from that same environment. | ||
Alternatively, run `init.ps1 -InstallLocality Machine` (which may require elevation) in order to install dependencies at machine-wide locations so Visual Studio and builds work everywhere. | ||
|
||
The only prerequisite for building, testing, and deploying from this repository | ||
is the [.NET SDK](https://get.dot.net/). | ||
You should install the version specified in `global.json` or a later version within | ||
the same major.minor.Bxx "hundreds" band. | ||
For example if 2.2.300 is specified, you may install 2.2.300, 2.2.301, or 2.2.310 | ||
while the 2.2.400 version would not be considered compatible by .NET SDK. | ||
See [.NET Core Versioning](https://docs.microsoft.com/dotnet/core/versions/) for more information. | ||
|
||
## Package restore | ||
|
||
The easiest way to restore packages may be to run `init.ps1` which automatically authenticates | ||
to the feeds that packages for this repo come from, if any. | ||
`dotnet restore` or `nuget restore` also work but may require extra steps to authenticate to any applicable feeds. | ||
|
||
## Building | ||
|
||
This repository can be built on Windows, Linux, and OSX. | ||
|
||
Building, testing, and packing this repository can be done by using the standard dotnet CLI commands (e.g. `dotnet build`, `dotnet test`, `dotnet pack`, etc.). | ||
|
||
[pwsh]: https://docs.microsoft.com/powershell/scripting/install/installing-powershell?view=powershell-6 | ||
|
||
## Releases | ||
|
||
Use `nbgv tag` to create a tag for a particular commit that you mean to release. | ||
[Learn more about `nbgv` and its `tag` and `prepare-release` commands](https://github.com/dotnet/Nerdbank.GitVersioning/blob/main/doc/nbgv-cli.md). | ||
|
||
Push the tag. | ||
|
||
### GitHub Actions | ||
|
||
When your repo is hosted by GitHub and you are using GitHub Actions, you should create a GitHub Release using the standard GitHub UI. | ||
Having previously used `nbgv tag` and pushing the tag will help you identify the precise commit and name to use for this release. | ||
|
||
After publishing the release, the `.github\workflows\release.yml` workflow will be automatically triggered, which will: | ||
|
||
1. Find the most recent `.github\workflows\build.yml` GitHub workflow run of the tagged release. | ||
1. Upload the `deployables` artifact from that workflow run to your GitHub Release. | ||
1. If you have `NUGET_API_KEY` defined as a secret variable for your repo or org, any nuget packages in the `deployables` artifact will be pushed to nuget.org. | ||
|
||
### Azure Pipelines | ||
|
||
When your repo builds with Azure Pipelines, use the `azure-pipelines/release.yml` pipeline. | ||
Trigger the pipeline by adding the `auto-release` tag on a run of your main `azure-pipelines.yml` pipeline. | ||
|
||
## Tutorial and API documentation | ||
|
||
API and hand-written docs are found under the `docfx/` directory. and are built by [docfx](https://dotnet.github.io/docfx/). | ||
|
||
You can make changes and host the site locally to preview them by switching to that directory and running the `dotnet docfx --serve` command. | ||
After making a change, you can rebuild the docs site while the localhost server is running by running `dotnet docfx` again from a separate terminal. | ||
|
||
The `.github/workflows/docs.yml` GitHub Actions workflow publishes the content of these docs to github.io if the workflow itself and [GitHub Pages is enabled for your repository](https://docs.github.com/en/pages/quickstart). |
This file contains 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