Merge pull request #2599 from asbjornu/feature/website-refresh

Refresh website

Author: asbjornu

.github/workflows/docs.yml

@@ -0,0 +1,22 @@
+name: Verify Documentation
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+      with:
+        fetch-depth: 0
+
+    - name: '[Build Documentation]'
+      shell: pwsh
+      run: ./build.ps1 -Target Build-Documentation
+
+    - name: '[HTMLProofer]'
+      uses: chabad360/htmlproofer@master
+      with:
+        directory: ./artifacts/Documentation
+        arguments: --url-ignore /api/ --allow-hash-href --assume-extension --disable-external

BREAKING_CHANGES.md

@@ -42,6 +42,6 @@ work for you
   `GitVersionConfig.yaml` instead
 - GitVersionTask's `ReleaseDateAttribute` no longer exists
 
-[gitflow]: https://gitversion.net/docs/git-branching-strategies/gitflow-examples_complete
+[gitflow]: https://gitversion.net/docs/learn/branching-strategies/gitflow-examples_complete
 [pr-1541]: https://github.com/GitTools/GitVersion/pull/1541
 [pr-1581]: https://github.com/GitTools/GitVersion/pull/1581

CONTRIBUTING.md

@@ -5,7 +5,7 @@ We love contributions to get started contributing you might need:
 - [Get started with git](http://rogerdudler.github.io/git-guide)
 - [How to create a pull request](https://help.github.com/articles/using-pull-requests)
 - [An issue to work on](https://github.com/GitTools/GitVersion/labels/up-for-grabs) - We are on [Up for grabs](http://up-for-grabs.net/), our up for grabs issues are tagged `up-for-grabs`
-- An understanding of our [architecture](http://gitversion.readthedocs.org/en/latest/more-info/how-it-works/#architecture) and how [we write tests](#writing-tests)
+- An understanding of our [architecture](http://gitversion.net/docs/learn/how-it-works#architecture) and how [we write tests](#writing-tests)
 
 Once you know how to create a pull request and have an issue to work on, just post a comment saying you will work on it.
 If you end up not being able to complete the task, please post another comment so others can pick it up.
@@ -23,7 +23,7 @@ Issues are also welcome, [failing tests](#writing-tests) are even more welcome.
 
 ## How it works
 
-See [how it works](http://gitversion.readthedocs.org/en/latest/more-info/how-it-works/) in GitVersion's documentation
+See [how it works](http://gitversion.net/docs/learn/how-it-works/) in GitVersion's documentation
 
 ## Writing Tests
 

README.md

@@ -84,7 +84,7 @@ from The Noun Project.
 [contribute]:                      https://github.com/GitTools/GitVersion/blob/main/CONTRIBUTING.md
 [why]:                             https://gitversion.net/docs/why
 [usage]:                           https://gitversion.net/docs/usage/usage
-[how]:                             https://gitversion.net/docs/more-info/how-it-works
+[how]:                             https://gitversion.net/docs/learn/how-it-works
 [faq]:                             https://gitversion.net/docs/faq
 [who]:                             https://gitversion.net/docs/who
 [gv-in-action]:                    https://raw.github.com/GitTools/GitVersion/master/docs/input/docs/img/README.png

build/docs.cake

@@ -23,7 +23,7 @@ Task("Preview-Documentation")
     });
 });
 
-Task("Force-Publish-Documentation")
+Task("Build-Documentation")
     .IsDependentOn("Clean-Documentation")
     .WithCriteria(() => DirectoryExists(MakeAbsolute(Directory("docs"))), "Wyam documentation directory is missing")
     .Does<BuildParameters>((parameters) =>
@@ -37,7 +37,12 @@ Task("Force-Publish-Documentation")
         ConfigurationFile = MakeAbsolute((FilePath)"config.wyam"),
         Settings = parameters.WyamAdditionalSettings
     });
+});
 
+Task("Force-Publish-Documentation")
+    .IsDependentOn("Build-Documentation")
+    .Does<BuildParameters>((parameters) =>
+{
     PublishDocumentation(parameters);
 });
 

docs/input/_Card.cshtml

@@ -0,0 +1,13 @@
+<div class="card">
+    <div class="card-header">
+        <img src="/assets/img/@Model.String("CardIcon")" alt="" aria-hidden="true">
+        <h5>@Html.Raw(Model.String(Keys.Title))</h5>
+    </div>
+
+    <div class="card-body">
+        <p class="card-text">@Html.Raw(Model.String(DocsKeys.Description))</p>
+        <a href="/@Model.String(Keys.RelativeFilePathBase)" class="btn btn-primary">
+            @Html.Raw(Model.String(Keys.Title))
+        </a>
+    </div>
+</div>

docs/input/_Head.cshtml

@@ -1,3 +1,13 @@
 <meta name="google" content="notranslate">
 <meta http-equiv="Content-Language" content="en">
 <meta name="google-site-verification" content="46g_yrsDyk5YTGoXb2ii9BjmTJ2QAEsacqn6wqiAiII" />
+<meta property="og:image" content="https://github.com/GitTools/graphics/raw/master/GitVersion/banner-1280x640.png" />
+<meta property="og:site_name" content="GitVersion" />
+<meta property="og:type" content="object" />
+<meta property="og:title" content="GitVersion" />
+<meta property="og:url" content="https://gitversion.net/" />
+<meta property="og:description" content="From git log to SemVer in no time" />
+<link rel="icon" href="/assets/img/icon.png" type="image/png">
+<link rel="icon" href="/assets/img/icon.svg" type="image/svg">
+<link rel="apple-touch-icon" href="/assets/img/icon.png" type="image/png">
+<link rel="apple-touch-icon" href="/assets/img/icon.svg" type="image/svg">