readme.md

GitVersion Documentation

This is the directory in which the GitVersion documentation hosted on GitHub Pages resides.

Contributing

Improvements to the documentation is highly welcomed and is as easy as finding the .md file you want to change and editing it directly within GitHub's web interface.

If you want to do more elaborate changes, we would appreciate if you could test the documentation locally before submitting a pull request. This involves forking this repository and then serving up the documentation locally on your machine, clicking around in it to ensure that everything works as expected.

Serving the documentation locally

To serve up the documentation locally, you need to run the following commands:

./build.ps1 -Stage build -Target PrepareBuild
./build.ps1 -Stage build -Target Build
./build.ps1 -Stage docs -Target PreviewDocs

On Windows

On Windows, you need to run the following commands in a PowerShell terminal:

./build.ps1 -Stage build -Target PrepareBuild
./build.ps1 -Stage build -Target Build
./build.ps1 -Stage docs -Target PreviewDocs

On Unix

First you need to install PowerShell on macOS or Linux, then execute the following commands:

./build.ps1 -Stage build -Target PrepareBuild
./build.ps1 -Stage build -Target Build
./build.ps1 -Stage docs -Target PreviewDocs

After pressing enter, the documentation will be generated and then served under a local web server. Information about the URL that can be used to view the docs will be shown in the output. Copy/paste this URL into a browser window.