Merge pull request #802 from bart-degreed/fix-nuget-cibuild

Fixed versioning on AppVeyor NuGet feed; added documentation

Author: Bart Koelman

.gitignore

@@ -134,6 +134,9 @@ _ReSharper*/
 *.[Rr]e[Ss]harper
 *.DotSettings.user
 
+# JetBrains Rider
+.idea/
+
 # TeamCity is a build add-in
 _TeamCity*
 

Build.ps1

@@ -38,18 +38,19 @@ If($env:APPVEYOR_REPO_TAG -eq $true) {
 
     IF ([string]::IsNullOrWhitespace($revision)){
         Write-Output "RUNNING dotnet pack .\src\JsonApiDotNetCore -c Release -o .\artifacts"
-        dotnet pack .\src\JsonApiDotNetCore -c Release -o .\artifacts --include-symbols
+                              dotnet pack .\src\JsonApiDotNetCore -c Release -o .\artifacts
         CheckLastExitCode
     }
     Else {
         Write-Output "RUNNING dotnet pack .\src\JsonApiDotNetCore -c Release -o .\artifacts --version-suffix=$revision"
-        dotnet pack .\src\JsonApiDotNetCore -c Release -o .\artifacts --version-suffix=$revision --include-symbols
+                              dotnet pack .\src\JsonApiDotNetCore -c Release -o .\artifacts --version-suffix=$revision
         CheckLastExitCode
     }
 }
-Else { 
-    Write-Output "VERSION-SUFFIX: alpha5-$revision"
-    Write-Output "RUNNING dotnet pack .\src\JsonApiDotNetCore -c Release -o .\artifacts --version-suffix=alpha1-$revision"
-    dotnet pack .\src\JsonApiDotNetCore -c Release -o .\artifacts --version-suffix=alpha1-$revision --include-symbols
+Else {
+    $packageVersionSuffix="alpha5-$revision"
+    Write-Output "VERSION-SUFFIX: $packageVersionSuffix"
+    Write-Output "RUNNING dotnet pack .\src\JsonApiDotNetCore -c Release -o .\artifacts --version-suffix=$packageVersionSuffix"
+                          dotnet pack .\src\JsonApiDotNetCore -c Release -o .\artifacts --version-suffix=$packageVersionSuffix
     CheckLastExitCode
 }

README.md

@@ -121,3 +121,15 @@ A lot of changes were introduced in v4.0.0, the following chart should help you
 | ----------------- | ------------- |
 | 2.*               | v3.*          |
 | 3.*               | v4.*          |
+
+## Trying out the latest build
+
+After each commit, a new prerelease NuGet package is automatically published to AppVeyor at https://ci.appveyor.com/nuget/jsonapidotnetcore. To try it out, follow the next steps:
+
+* In Visual Studio: **Tools**, **NuGet Package Manager**, **Package Manager Settings**, **Package Sources**
+    * Click **+**
+    * Name: **AppVeyor JADNC**, Source: **https://ci.appveyor.com/nuget/jsonapidotnetcore**
+    * Click **Update**, **Ok**
+* Open the NuGet package manager console (**Tools**, **NuGet Package Manager**, **Package Manager Console**)
+    * Select **AppVeyor JADNC** as package source
+    * Run command: `Install-Package JonApiDotNetCore -pre`